Developer Quickstart

Prerequisites

Ensure you have the following tools installed:

Core Requirements

• Node.js (v18 – v24) - JavaScript runtime

• pnpm (v8 or higher) - Package manager

  npm install -g pnpm
  

• Git - Version control

Kubernetes Development

• Tilt - Development environment orchestrator
• kubectl - Kubernetes CLI
• Helm - Package manager for Kubernetes
• 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

Note: By default, the platform allows localhost origins on any port for CORS configuration. For production deployments or custom CORS configuration, see Environment Variables.

3. Dependency Security

The platform has two security protections:

1. Install scripts are disabled - Prevents malicious code execution during install
2. 7-day minimum release age - Delays installation of newly published packages

If a package requires scripts to work:

pnpm rebuild <package-name>

This is rarely needed. Most packages work without scripts.