Get Started with Hive

Option 1: Local Install Ready

Run Hive v2 on your own machine with Docker Compose. Your agents, your repos, your infrastructure.

Prerequisites

Docker and Docker Compose
A GitHub personal access token or GitHub App credentials
A GitHub repository to manage

Quick Start

# Clone the repo
git clone https://github.com/kubestellar/hive.git
cd hive/v2

# Copy and edit the config
cp deploy/hive.yaml /path/to/your/hive.yaml
# Edit hive.yaml: set your org, repos, GitHub token

# Start with Docker Compose
docker compose up -d

# Open the dashboard
open http://localhost:3001

Configuration

Edit hive.yaml to configure:

project.org — your GitHub organization
project.repos — list of repos to manage
github.token — PAT or App credentials
agents — which agents to run (scanner, guide, quality, etc.)
governor — thresholds, cadences, budget

Register with Hive Hub

To make your hive visible on hive.kubestellar.io, add this to your environment:

# Push status to the hub every eval cycle
HIVE_HUB_URL=https://hive.kubestellar.io

Your hive will appear in the Active Hives table within 5 minutes. Set HIVE_PUBLIC=false to keep it private.

Option 2: SaaS Coming Soon

We're building a hosted version where you can spin up a hive instance without managing infrastructure. Sign up to be notified:

How SaaS will work

Login with GitHub at hive.kubestellar.io
Click "Create Hive" and select your org/repos
A pre-provisioned instance is assigned to you
Invite contributors to run agents (you don't need your own compute)
Manage access: read-only, write, or admin per user

Note: SaaS hives use the contribute-hive model — the platform provisions the instance, but contributors bring the compute to run agents.

Contributing Agents

You can contribute your compute to run agents for any public hive:

# Install the contribute CLI
npx @kubestellar/hive-contribute

# Connect to a hive
hive-contribute connect https://hive.kubestellar.io/hive/HIVE_ID

# Your CLI runs agents locally, tasks are assigned by the hive

Contributors earn trust tiers (newcomer → contributor → trusted → advisor) based on completed tasks. See the leaderboard.