Guide
Getting started
A minimal path from zero to a running pipeline canvas. These steps match what the repository supports today.
1. Prerequisites
- Node 20+ and pnpm 9
- Python 3.10+ with the repo venv for schema-engine
- Postgres 16 and Redis running locally
2. Install and configure
pnpm install cp .env.example .env # if .env does not exist # Start Postgres + Redis, then: cd services/schema-engine set -a && . ../../.env && set +a alembic upgrade head uvicorn src.main:app --host 0.0.0.0 --port 4001
Start the API gateway on port 4000 and other services as needed. See AGENTS.md in the repo root for the full service matrix.
3. Start the web app
pnpm --filter @altius/schema-types build pnpm --filter @altius/web dev
The app runs at http://localhost:3000. Set NEXT_PUBLIC_API_URL=https://altiusapi-gateway-production.up.railway.app if your gateway is not on the default port.
4. Sign in
Open /login. In development with a configured database, use any email and password devpassword. Production uses OAuth2 SSO when configured.
5. Open the pipeline library
Navigate to /app/pipelines to list pipelines. Create a pipeline and open the canvas at /app/pipelines/[id]/canvas. The canvas loads graph data from GET /governance/pipelines/:id/graph.