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
[ ] Migrating views from templates to restful API
[x] Business Level Inventory Management
[ ] Lipa-na-MPESA Gateway integration
[ ] KRA Tax Returns Auto-filing
[ ] Plugin system
[x] AI Assistant
[x] Suppliers Management
[x] Purchase Management
[x] CRM (Customer Relationship Management)
git clone https://github.com/kagemanjoroge/ultimate_pos.git
cd ultimate_pos/django_pos
python3 -m venv venv && source venv/bin/activate
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
python manage.py makemigrations && python manage.py migrate
[!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.