---
title: Installation
description: Step-by-step guide to installing VibeCoder Heretic using Docker, Kubernetes, or local development setup
canonical: https://giglabo.com/heretic/docs/getting-started/installation
locale: en
---

# Installation

> Markdown twin of https://giglabo.com/heretic/docs/getting-started/installation
> Fetch this instead of the HTML page: same content, a fraction of the bytes.
> Site structure and the full page list for agents: https://giglabo.com/llms.txt

Step-by-step guide to installing VibeCoder Heretic using Docker, Kubernetes, or local development setup

## Prerequisites

Before installing, ensure you have:

- **Node.js 22+** - Required for the frontend and orchestrator
- **Docker** - Recommended for containerized deployment
- **Git** - For cloning the repository

## Docker Installation (Recommended)

The fastest way to get started is using Docker Compose.

### Clone the Repository

```bash
git clone https://github.com/giglabo/heretic.git
cd heretic
```

### Configure Environment

Copy the example environment file and configure your settings:

```bash
cp .env.example .env
```

Edit `.env` and add your API keys:

```env
ANTHROPIC_API_KEY=your-api-key-here
TRELLO_API_KEY=your-trello-key
TRELLO_TOKEN=your-trello-token
```

### Start Services

```bash
docker compose up -d
```

This will start:
- Orchestrator service on port 8000
- Frontend application on port 3000
- PostgreSQL database on port 5432

## Local Development Setup

For development, you can run services locally.

### Install Dependencies

```bash
# Frontend
cd heretic-vibe-coder
pnpm install

# Backend
cd ../orchestrator-service
pip install -e .
```

### Run Development Servers

```bash
# Terminal 1: Frontend
cd heretic-vibe-coder
pnpm --filter app dev

# Terminal 2: Backend
cd orchestrator-service
uvicorn app.main:app --reload
```

## Kubernetes Deployment

For production deployments, use the provided Kubernetes manifests.

```bash
kubectl apply -f orchestrator-service/k8s/
```

> **Warning: Production Configuration**
>
> Make sure to configure proper secrets and persistent volumes for production deployments.

## Verify Installation

After installation, verify everything is working:

```bash
# Check orchestrator health
curl http://localhost:8000/health

# Open frontend
open http://localhost:3000
```

## Next Steps

Once installed, proceed to the [Quick Start](https://giglabo.com/heretic/docs/getting-started/quick-start) guide to run your first workflow.

## Related

- HTML version of this page: https://giglabo.com/heretic/docs/getting-started/installation
- Site map for agents: https://giglabo.com/llms.txt