Setup

Prerequisites

• Node.js and pnpm
• Python 3.10+ and uv (install from https://github.com/astral-sh/uv)

Environment Variables

Create a .env file in the project root with:

# postgres db that volur is connected to to run queries on for DS workflows
CONNECTED_DATABASE_URL=postgresql://user:password@localhost:5432/dbname

# postgres db powering volur
DATABASE_URL=postgresql://user:password@localhost:5432/dbname
ANTHROPIC_API_KEY=your_anthropic_api_key

Optional:

SECRET_KEY=your_secret_key
LANGSMITH_API_KEY=your_langsmith_api_key  # For tracing

Running the Project

Frontend

pnpm install
pnpm dev

Backend

pnpm sync:backend
pnpm dev:backend

The frontend runs on http://localhost:5173 and the backend on http://localhost:8000.

Database Migrations

Generate a migration:

cd backend
alembic revision --autogenerate -m "description"

Apply migrations:

cd backend
alembic upgrade head