Overview

This guide walks you through deploying Tuneloop on your infrastructure and connecting your first coding agent harness.

Prerequisites

  • Docker and Docker Compose (for Docker-based deployment), or a Kubernetes cluster with Helm (for Helm-based deployment)
  • Postgres 17 (included in the Docker Compose setup)
  • An LLM API key for session enrichment (Anthropic, OpenAI, AWS Bedrock, or any OpenAI-compatible gateway — see Configuration)
  • A GitHub App for PR attribution and outcome linking
  • Node.js 22+ on machines where your agents run (for the ingest CLI)

Deployment Options

Tuneloop runs entirely on your infrastructure. Choose your deployment method:

  • Docker Compose — the fastest path. Single command, everything included.
  • Helm Charts — for production Kubernetes deployments.

Once deployed, configure your instance and connect your integrations:

  • Configuration — LLM enrichment, ingest tokens, and admin setup.
  • Integrations — connect coding agent harnesses, GitHub, and Jira.