A modern POS/ERP/CRM system for businesses of the AI era. Powered by Django.
You can access the demo here. The credentials are:
username: demo
password: 12345678
- Dashboard Page with statistics and graphs
- DataTables with print, copy, to CSV, and to PDF buttons
- Categories and Products Management
- Clients Management
- Sales Management
- eTIMS(electronic Tax Invoice Management System)
-
Migrating views from templates to restful API
-
Business Level Inventory Management
-
Lipa-na-MPESA Gateway integration
-
KRA Tax Returns Auto-filing
-
Plugin system
-
AI Assistant
-
Suppliers Management
-
Purchase Management
-
CRM (Customer Relationship Management)
- Add feature to renew subscription
- Add Lipa na Mpesa Support
- Update the documentation to document management commands
- Clone or download the repository:
git clone https://github.com/kagemanjoroge/ultimate_pos.git
- Go to the project directory
cd ultimate_pos/django_pos
- Create a virtual environment :
python3 -m venv venv && source venv/bin/activate
- Install dependencies:
pip install -r requirements.txt
-
Install GTK to create the PDF files:
Official documentation -
Windows:
After installing GTK, you need to add it to your system's Path environment variable. Follow these steps:-
Assuming you installed GTK at:
C:\Program Files\GTK3-Runtime Win64\bin
This will be your new variable that you need to add to Path -
Refer to this tutorial for detailed instructions on adding to the Path environment variable: Adding variable to path
-
If you encounter an error such as "cannot load library," refer to this documentation for troubleshooting: Missing Library Error
-
-
Restart your computer: After completing the steps above, it is essential to restart your computer for the changes to take effect properly.
After restarting your computer
-
Go to the project directory:
cd ultimate_pos
-
Activate the virtual enviroment
source venv/bin/activate
-
Go to the django_pos folder:
cd ultimate_pos/django_pos
-
Copy the .env.example file to .env: Replace the values with your own values
cp .env.example .env
- Create a Firebase collection and add the pricing data as you wish your pricing to be.
Example: - Make database migrations:
python manage.py makemigrations && python manage.py migrate
- Create superuser to access the admin panel:
Important
You will need a super user account in order to access the admin page. You can create one by running the following command:
python manage.py createsuperuser
with the following data, or with the data you prefer:
username: YOUR_PREFERRED_USERNAME
password: YOUR_PASSWORD
email: YOUR_EMAIL@EMAIL.COM
-
Run the server:
python manage.py runserver
-
Open a browser and navigate :
http://127.0.0.1:8000/
-
Log In with your superuser credentials.
Contributions are always welcome!
-
Fork this repository;
-
Create a branch with your feature:
git checkout -b my-feature
; -
Commit your changes:
git commit -m "feat: my new feature"
; -
Push to your branch:
git push origin my-feature
.
This project is under MIT License.