Getting Started¶
AXIS is a monorepo containing a Next.js 14 frontend and a FastAPI backend for AI evaluation dashboards. The two services communicate over HTTP and can run locally for development or be deployed as containers in production.
Local Development¶
For local development, both services run on your machine:
| Service | URL | Port |
|---|---|---|
| Frontend | http://localhost:3500 | 3500 |
| Backend | http://localhost:8500 | 8500 |
| API Docs | http://localhost:8500/docs | 8500 |
Production Deployment¶
In production, AXIS runs as Docker containers behind a reverse proxy. The URLs are determined by your infrastructure:
| Service | Typical Setup |
|---|---|
| Frontend | https://your-domain.com (served by Next.js standalone) |
| Backend | https://your-domain.com/api or https://api.your-domain.com |
| Database | PostgreSQL + DuckDB (analytics cache) |
See the Deployment guide for Docker Compose, container orchestration, reverse proxy setup, and the production checklist.
Next Steps¶
-
Installation
Install prerequisites, clone the repo, and configure environment files for local development.
-
First Run
Start the dev servers, load data, and explore the dashboard locally.
-
Deploy
Run AXIS in production with Docker, reverse proxy, and database configuration.