AI University

AI University is a personalized AI-powered UPSC coaching backend. The first MVP focuses on one complete study loop: route a student request, teach Polity using memory and trusted sources, generate MCQs, store progress, and schedule revision.

Local Setup

Create a virtual environment and install dependencies:

python -m venv .venv
source .venv/bin/activate
python -m pip install -e ".[dev]"

On Windows PowerShell:

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -e ".[dev]"

Copy environment defaults:

cp .env.example .env

Set your Gemini API key in .env:

GEMINI_API_KEY=your-google-ai-studio-key

Start local infrastructure:

docker compose up -d

Run the API:

uvicorn app.main:app --reload

Health check:

GET /api/v1/health

Session lifecycle:

POST /api/v1/users/{user_id}/sessions
GET /api/v1/users/{user_id}/sessions/{session_id}
DELETE /api/v1/users/{user_id}/sessions/{session_id}

Development

Run tests:

pytest

Run linting:

ruff check .

See project planning and architecture in docs/.