Installation

All Candela components live in the candelahq/candela monorepo.

candela CLI (Recommended Start)

The fastest way to get started — a developer proxy that manages local and cloud models with built-in observability.

brew install candelahq/tap/candela

go install github.com/candelahq/candela/cmd/candela@latest

git clone https://github.com/candelahq/candela.git
cd candela
nix develop   # or ensure Go 1.26+ is installed
go run ./cmd/candela

Create ~/.config/candela/config.yaml:

runtime_backend: ollama
port: 8181
lm_studio_port: 1234

To use cloud models (Gemini, Claude via Vertex AI) or connect to a shared Candela server, authenticate once:

candela auth login     # opens browser — Google OAuth flow
candela auth status    # verify credentials

Credentials are stored at ~/.config/candela/adc.json (ADC-compatible). No gcloud CLI required.

The full backend with dashboard UI, deployed on Cloud Run.

git clone https://github.com/candelahq/candela.git
cd candela
nix develop -c go run ./cmd/candela-server

See candela-server docs for Cloud Run deployment with Terraform.

Lightweight production proxy for container environments.

docker pull ghcr.io/candelahq/candela-sidecar:latest

go install github.com/candelahq/candela/cmd/candela-sidecar@latest

git clone https://github.com/candelahq/candela.git
cd candela
go build -o candela-sidecar ./cmd/candela-sidecar

Desktop app for provider management and trace visualization.

brew install --cask candelahq/tap/candela-desktop

candela version