Get Started

Install, configure, and run Nex‑T1 locally or with Docker. Authentication and session flow for users.

Get Started

1. Prerequisites

   • Python 3.13+
   • PostgreSQL (local or managed)
   • Docker & Docker Compose (optional)
2. Install dependencies

   uv

   uv sync
   
3. Configure environment

   Copy and edit an env file (see .env.development, .env.staging, .env.production). Critical keys: LLM_API_KEY, JWT_SECRET_KEY, POSTGRES_*, optional MCP bases.

4. Run the API

   Local

   make dev
   # or: uvicorn app.main:app --host 0.0.0.0 --port 8000
   

   make docker-build-env ENV=development
   make docker-run-env   ENV=development
   

   Swagger UI: http://localhost:8000/docs | Metrics: /metrics

Authentication & Sessions

Register

curl -X POST http://localhost:8000/api/v1/auth/register \
  -H 'Content-Type: application/json' \
  -d '{"email":"[e-mail]","password":"StrongP@ssw0rd"}'

curl -X POST http://localhost:8000/api/v1/auth/login \
  -F username=[e-mail] -F password=StrongP@ssw0rd

curl -X POST http://localhost:8000/api/v1/auth/session \
  -H 'Authorization: Bearer <user_access_token>'

Rate Limiting & CORS

• Rate limiting via SlowAPI; defaults configurable in app/core/config.py (e.g., RATE_LIMIT_ENDPOINTS).
• CORS configured in app/main.py from ALLOWED_ORIGINS env var.