eval_752
  • English

      • Installation

      Three ways to run eval_752, depending on your goals.

      The fastest path. Boots the full stack — PostgreSQL, Redis, FastAPI, Celery, and the React frontend — in one command.

      Requirements:

      • Docker Desktop installed and running
      • At least 4 GB RAM and 2 CPU cores allocated to Docker
      git clone https://github.com/t41372/eval_752.git
cd eval_752
cp .env.example .env
openssl rand -hex 32  # Paste into ENCRYPTION_KEY in .env
docker compose up --build -d

      Verify it's healthy:

      curl http://localhost:8000/healthz   # → {"status":"ok"}

      Then open http://localhost:5173.

      The workspace starts empty — that's by design. See Quick Start for the full first-run walkthrough.

      Using prebuilt images (GHCR)

      Skip the build step by pulling published images:

      git clone https://github.com/t41372/eval_752.git
cd eval_752
cp .env.example .env
docker compose -f docker-compose.ghcr.yml pull
docker compose -f docker-compose.ghcr.yml up -d

      Local development

      For contributors who want to run services outside Docker.

      Requirements:

      • Python 3.12+, Node.js 20+, PostgreSQL 14+, Redis 7+
      • Astral uv for Python dependencies
      • pnpm for frontend dependencies

      Backend

      cd backend
uv sync --extra dev
uv run alembic upgrade head
uv run uvicorn eval_752.app.main:app --reload

      Frontend

      cd frontend
pnpm install
pnpm dev

      Workers (separate terminals)

      cd backend
uv run celery -A eval_752.workers.app worker --loglevel=info

# In another terminal:
uv run celery -A eval_752.workers.app beat

      Production deployment

      See the Deployment Guide for production strategies.

      Next steps