- Python 3.8+
- Node.js 18+
- PostgreSQL
- Redis (optional, for Celery)
-
Navigate to backend:
cd backend -
Create and activate virtual environment:
python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate
-
Install dependencies:
pip install -r requirements.txt
-
Configure environment:
cp .env.example .env # Edit .env with your database credentials -
Run migrations:
python manage.py makemigrations python manage.py migrate
-
Create superuser:
python manage.py createsuperuser # Or use the sample data command which creates one -
Load sample data (optional):
python manage.py load_sample_data
-
Run server:
python manage.py runserver
-
Navigate to frontend:
cd frontend -
Install dependencies:
npm install
-
Run development server:
npm run dev
- Frontend: http://localhost:3000
- Backend API: http://localhost:8000
- API Documentation: http://localhost:8000/api/docs/
- Django Admin: http://localhost:8000/admin/
-
Master Admin:
- Email: admin@timetable.com
- Password: admin123
-
College Admin:
- Email: admin@democollege.com
- Password: admin123
-
Teachers:
- Email: teacher1@demo.com, teacher2@demo.com, etc.
- Password: teacher123
- Ensure PostgreSQL is running
- Check database credentials in
.env - Verify database exists:
createdb timetable_db
- Clear node_modules and reinstall:
rm -rf node_modules && npm install - Check Node.js version:
node --version(should be 18+)
- Ensure all dependencies are installed
- Check Python virtual environment is activated
- Verify all migrations are applied
- Create your first college via Master Admin dashboard
- Add departments, teachers, subjects, and sections
- Generate your first timetable
- Customize the algorithm parameters as needed