Developer Quickstart

Prerequisites

Ensure you have the following tools installed:

Core Requirements

• Node.js (v18 or higher) - JavaScript runtime
• pnpm (v8 or higher) - Package manager

  npm install -g pnpm
  

• Git - Version control

Kubernetes Development

• Tilt - Development environment orchestrator
• kubectl - Kubernetes CLI
• Local Kubernetes cluster - Choose one:
  • Docker Desktop with Kubernetes enabled
  • Kind (Kubernetes in Docker)
  • OrbStack (macOS recommended)

Development Tools

• Biome VSCode extension - Code formatting and linting

Quick Start

1. Clone the Repository

git clone https://github.com/archestra-ai/archestra.git
cd archestra/platform

2. Launch Development Environment

Start the local Kubernetes development environment with Tilt:

tilt up

This command will:

• Build and deploy all platform services to your local Kubernetes cluster
• Set up hot-reload for code changes
• Open the Tilt UI at http://localhost:10350
• Open the Archestra UI at http://localhost:3000