Deployment
The project is prepared for Vercel, Render, Railway, Hugging Face Spaces, Docker Compose, and GitHub Actions.
Key Points
Vercel is recommended for the Next.js frontend.
Render or Railway can run backend and MCP Docker services.
Hugging Face Spaces is a good free Docker option for the MCP server.
Services
Deploy three services: frontend, backend, and MCP. Point every service to the same Neon database-backed backend URL where needed.
Frontend needs BACKEND_URL, NEXT_PUBLIC_BACKEND_URL, MCP_SERVER_URL, AUTH_COOKIE_SECRET, and AI keys.
Backend needs DATABASE_URL, JWT_SECRET_KEY, CORS_ORIGINS, TYPE=remote, and ENV=production.
MCP needs BACKEND_URL, FRONTEND_URL, and PORT.
CI/CD
GitHub Actions compile Python services, build the frontend, optionally publish Docker images to GHCR, deploy the MCP server to Hugging Face, trigger platform deploy hooks, and run scheduled retention cleanup.
Docker
For local production-style testing, create .env.docker from .env.docker.example and run docker compose with docker-compose.prod.yml.