Merry Chama is a Django web application for managing chama groups, contributions, and member interactions.
- User registration and login
- Create and join chama groups
- Track contributions and payouts
- Dashboard for group management
- Responsive web interface
- Python 3.11+
- Django 6.0
- Virtual environment
Run the project with:
bash start.shThis will:
- create a virtual environment if needed
- install dependencies
- apply migrations
- start the Django development server at http://0.0.0.0:8000/
-
Create and activate a virtual environment
python3 -m venv .venv source .venv/bin/activate -
Install dependencies
pip install -r requirements.txt
-
Apply migrations
python manage.py migrate
-
Run the development server
python manage.py runserver 0.0.0.0:8000
Copy the example file and update values as needed:
cp .env.example .envExample variables:
SECRET_KEY=change-me
DEBUG=False
ALLOWED_HOSTS=localhost,127.0.0.1,your-domain.com
CSRF_TRUSTED_ORIGINS=http://localhost,http://127.0.0.1,https://your-domain.com
DB_ENGINE=django.db.backends.sqlite3
DB_NAME=db.sqlite3chama/- main Django app containing models, views, forms, and URLsmerry_chama/- project settings and configurationtemplates/- HTML templatesstatic/- CSS, JavaScript, and other static assets