Get started

# Get a hosted hive

Request a hive for your project in three steps. We provision it on our infrastructure — no Kubernetes, no setup, no compute needed.

1 Login
→
2 Your Repo
→
3 Request

## Login with GitHub

We use your GitHub identity to know who is asking — nothing more. We request no permissions on your account, and no passwords are stored.

Login with GitHub
✓ Authenticated

## Your repository

Paste the URL of the repository the hive should manage. You can add more later from your dashboard.

Repository URL

With or without `https://`. Works for public GitHub and for GitHub Enterprise (`github.ibm.com` and similar) — we record which instance the repo lives on and provision against it. Examples: `github.com/my-org/my-repo`, `https://github.ibm.com/my-org/my-repo`.

## Choose autonomy level

How much should the agents do on their own? Start low and increase as you build confidence. This only controls the mundane work — security patches, dependency updates, issue triage, test fixes — so your team can focus on what matters: innovation, outreach, and strategy.

Your name *

First and last name, so we know who the request is from — a GitHub username on its own often does not say who a person is.

Slack ID (optional)

Your Slack member ID or handle, if you have one. We use it to reach you about your hive — leave it blank and we will use GitHub instead.

Summary
Repo: none added
GitHub: github.com
ACMM Level:
Name: —
Slack ID: —

What happens next: an admin reviews your request. Once your hive is provisioned, its dashboard will prompt you to install the Hive GitHub App — with a link pointing at the right GitHub instance for your repos. Nothing to install before then.

Self-host

## Your agents, your infrastructure Ready

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

    git clone -b v2 https://github.com/kubestellar/hive.git
    cd hive/v2

    cp hive.yaml.example hive.yaml
    # Edit hive.yaml: set your org, repos, and GitHub token

    export HIVE_GITHUB_TOKEN=ghp_your_token_here
    docker compose up -d

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

A self-hosted hive is fully functional on its own — it does not need to be attached to hive.kubestellar.io.

Listing a hive you host yourself in the Active Hives table is a separate, operator-mediated step. Setting `HIVE_HUB_URL` on its own is not sufficient: the hub authenticates every heartbeat against `HIVE_HUB_SECRET`, which is issued by the hub operator — unauthenticated registration was deliberately removed to prevent registry pollution. To get a self-hosted hive listed, open an issue. If you would rather not run the infrastructure at all, use the hosted-hive wizard at the top of this page and the hub will provision and list one for you.

Contribute

## Contribute compute Ready

Lend your AI CLI to run agents for any public hive. Earn trust tiers and climb the leaderboard.

    npx @kubestellar/hive-contribute

    hive-contribute connect https://hive.kubestellar.io/hive/HIVE_ID

Your CLI runs agents locally. Tasks are assigned by the hive governor. You start as a newcomer and progress through contributor → trusted → advisor as you complete work.