Getting Started
This guide gets you from a fresh clone to a running portal in about 60 seconds.
Prerequisites
- Node.js 24+ (we use modern ESM features)
- Python 3.12+ (the backend uses match statements + extended type syntax)
- Claude Code installed, with a token from
claude setup-token
Install
git clone https://github.com/olafkfreund/AIFactory
cd AIFactory
npm run install:all
install:all runs the backend Python deps via uv and the frontend npm deps. First run takes ~2 minutes.
Configure your OAuth token
claude setup-token
# Copy the printed token, then:
echo "CLAUDE_CODE_OAUTH_TOKEN=<paste>" >> apps/backend/.env
Start the portal
# Terminal 1 — backend (FastAPI + WebSocket)
cd apps/web-server
python -m server.main
# Terminal 2 — frontend (Vite dev server)
cd apps/frontend-web
npm run dev
Open http://localhost:3100 — you should see the welcome screen. Add your first project and create a task.
What's next
- Run the demo → to see the full end-to-end flow against a public sample repo
- Concepts: Spec-Driven Development → for the why behind the planner/coder/QA loop
- Architecture → for how the pieces fit together