Installation
Set up Agent Studio for local development
Installation
This guide walks through setting up Agent Studio for local development.
Prerequisites
- Node.js 22+ (for docs and dashboard)
- Python 3.11+ (for backend)
- uv (Python package manager)
- pnpm (Node package manager)
- Docker & Docker Compose (for services)
- PostgreSQL 15+ (or use Docker)
- Redis 7+ (or use Docker)
Quick Start
1. Clone the Repository
git clone https://github.com/tap-health/agent-studio.git
cd agent-studio2. Set Up Python Environment
# Install uv if not already installed
curl -LsSf https://astral.sh/uv/install.sh | sh
# Create virtual environment and install dependencies
uv sync3. Set Up Node Environment
# Install pnpm if not already installed
npm install -g pnpm
# Install dependencies
pnpm install4. Configure Environment
# Copy example environment file
cp .env.example .env
# Edit .env with your configuration5. Start Services with Docker
docker-compose up -d postgres redis livekit6. Run Database Migrations
uv run alembic upgrade head7. Start Development Servers
# Terminal 1: API server
uv run uvicorn agent_studio.api:app --reload
# Terminal 2: Worker
uv run python -m agent_studio.worker
# Terminal 3: Dashboard
pnpm --filter @agent-studio/dashboard dev
# Terminal 4: Docs
pnpm --filter @agent-studio/docs devVerify Installation
- API: http://localhost:8000/docs
- Dashboard: http://localhost:3000
- Docs: http://localhost:3001
Next Steps
- Quickstart - Create your first workflow
- Configuration - Environment variables reference