# Clone the repository
git clone https://github.com/DavFilsDev/zenithAI_django-backend.git
cd zenithAI_django-backend
# Set up virtual environment
python -m venv venv
# Activate virtual environment
# Windows:
venv\Scripts\activate
# Mac/Linux:
source venv/bin/activate
# Install dependencies
pip install -r requirements.txt
# Set up environment variables
cp .env.example .env
# Edit .env file with your configuration
# Or run locally (requires PostgreSQL running)
python manage.py migrate
python manage.py runserver

• Python 3.11+
• PostgreSQL 15+
• Git

chatgpt-backend/
├── backend/ # Django project settings
├── chat/ # Chat app (conversations, messages)
├── users/ # User management app
├── requirements.txt # Python dependencies
├── .env.example # Environment variables template

docs/
├── api/ # API documentation
 ├── zenith-ai-api.postman_collection.json # Postman collection
 ├── zenith-ai-api.postman_environment.json # Postman environment
 └── api-documentation.md # Manual API docs

1. Open Postman
2. Click "Import" → "Upload Files"
3. Select both:
   • docs/api/zenith-ai-api.postman_collection.json
   • docs/api/zenith-ai-api.postman_environment.json
4. Select "Zenith AI - Development" environment from dropdown
5. Start testing!

1. Register a new user
2. Login to get tokens (automatically saved in environment)
3. Create conversation
4. Send messages
5. View conversations

• base_url: API base URL (default: http://127.0.0.1:8000)
• access_token: Automatically set after login
• refresh_token: Automatically set after login
• conversation_id: ID of current conversation

See API Documentation for detailed endpoint information.

1. Environment Variables (/.env):

SECRET_KEY=your-secret-key-here
DEBUG=True
ALLOWED_HOSTS=localhost,127.0.0.1
DB_NAME=chatgpt_db
DB_USER=postgres
DB_PASSWORD=postgres
DB_HOST=localhost
DB_PORT=5432
CORS_ALLOWED_ORIGINS=http://localhost:3000

2. Database Setup:
   • Manual: Create PostgreSQL database named chatgpt_db

• 📊 Interactive API Testing: Swagger UI
• 📖 Readable Reference: ReDoc
• 📋 OpenAPI Schema: schema.json

Uses JWT (JSON Web Tokens) for authentication:

• Access tokens valid for 1 day
• Refresh tokens valid for 7 days
• Include token in headers: Authorization: Bearer <token>

• Custom user with email as username
• API key storage
• Credit system
• Premium status

• Belongs to a user
• Has many messages
• Title and timestamps

• Belongs to a conversation
• Role (user/assistant/system)
• Content and token count

# Run tests
python manage.py test
# Run specific app tests
python manage.py test users
python manage.py test chat

1. Railway.app (recommended)

   # Install Railway CLI
   npm i -g @railway/cli
   # Login and deploy
   railway login
   railway up

2. Render.com

   • Connect GitHub repository
   • Set environment variables
   • Deploy with PostgreSQL addon

3. Fly.io

   # Install Fly CLI
   curl -L https://fly.io/install.sh | sh
   # Deploy
   fly launch
   fly deploy

• Django Admin: /admin/
• Database: Use Django shell or pgAdmin

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request

MIT License - see LICENSE file for details

• Issues: GitHub Issues
• Documentation: Check the Wiki
• Email: miharisoadavidfils@gmail.com

Author: Fanampinirina Miharisoa David Fils RATIANDRAIBE