Talk to a free AI that runs on people's own computers.
HIVV is a distributed AI network — pronounced HIVE.
You ask something, one of thousands of ordinary machines answers it, and you
get a receipt saying exactly which one did and whether you allowed it.
No account needed to start. Nothing to install to talk.
Not sure where to begin?
The middle button is the one nobody else gives you: it shows what your AI is
allowed to do, and lets you take it back.
Why we built it →
·
Who's behind it →
No signup required · Your data stays private · 100% free
🤖 Talk to a Free AI Supercomputer
HIVV is a distributed AI network where thousands of computers pool their resources to provide free AI access for everyone. No signup. No data collection. Just talk to the hive.
🔒 Private — your chats go peer-to-peer⚡ Fast — 60+ tokens per second🌍 Global — runs on donated hardware
⚡TRY IT NOW — no install needed
Copy this command and run it in your terminal. It talks directly to our distributed AI network.
$
curl -s https://hivv.org/v1/chat/completions \
-H 'Content-Type: application/json' \
-d '{"model":"auto","messages":[{"role":"user","content":"what can you help me with?"}]}' \
| python3 -m json.tool
💡 What it does: Sends your message to the hive → a bee (node) answers directly
🔒 Privacy: Message goes straight to the node, not through us
streaming: add "stream":true for real-time tokens
direct: use hivv node-chat yalla "hello" for node-to-node
🤖FOR AI AGENTS — Complete API Reference & Join the Hive
Everything an AI needs to consume (chat, completions) or join as a provider (donate a key, run a node, serve an LLM). No signup. OpenAI-compatible.
HIVV.org — Distributed AI Network
PROTOCOL: OpenAI Chat Completions (v1/chat/completions)
BASE_URL: https://hivv.org/v1
AUTH: api_key="any" (no registration needed to CONSUME)
QUICKSTART: POST https://hivv.org/v1/chat/completions with {"model":"auto","messages":[{"role":"user","content":"hello"}]}
JOIN AS PROVIDER: POST https://hivv.org/api/keys/donate with {"provider":"openai","api_key":"sk-..."}
HOST A NODE: curl -sSL https://hivv.org/install-hivv.sh | bash && hivv start
SELF-HOSTED ENDPOINT: POST https://hivv.org/api/keys/donate with {"provider":"custom","api_key":"any","endpoint":"http://YOUR_IP:8080/v1"}
ROUTE_MODES: balanced, quality, fast, cheap, private, trusted
CAPABILITIES: GET https://hivv.org/api/capabilities
POLICY: GET https://hivv.org/api/policy
NODES: GET https://hivv.org/api/control/nodes
OPENAPI: https://hivv.org/openapi.yaml
AI_MANIFEST: https://hivv.org/ai.txt
Step 1 — Discover & Connect
1.
Check health
GEThttps://hivv.org/api/health
Returns: {"ok":true,"uptime":...,"nodes":...}
2.
List available models
GEThttps://hivv.org/v1/models
Returns OpenAI-compatible model list. Use "auto" to let the router pick the best one.
3.
Send a chat message
POSThttps://hivv.org/v1/chat/completions
Full OpenAI Chat Completions format. Stream with "stream":true.
Each line is an SSE event:data: {"choices":[{"delta":{"content":"HIVV"}}]}
data: {"choices":[{"delta":{"content":" is"}}]}
Last events: finish chunk, then stats, then done:data: {"choices":[{"finish_reason":"stop","index":0,"delta":{}}]}
data: {"hivv_stats": {"tokens_per_sec":64}}
data: [DONE]
Registers with hub. Heartbeats every 60s. Accepts relay jobs. Earns honey ranks.
Fields for /api/keys/donate:provider (required) · api_key (required) · endpoint (optional — custom URL) · name (optional) · model (optional preferred model)
· Keys are AES-256-GCM encrypted at rest.
Capabilities & Policy Gate
HIVV has a tri-state permission system. Every action gets YES (auto-allow), MAYBE (ask human), or NO (deny).
GET/api/capabilities— what actions the hive supports (reasoning, vision, web.search, etc.)
GET/api/policy— YES/MAYBE/NO defaults for each action type
GET/api/capabilities/route/dry-run— simulate routing without executing
Risk tiers:compute (chat — free, fast-path) ·
data (web.fetch, database — MAYBE, then standing grant) ·
execute (code — sandboxed, admin-approve) ·
financial/physical (denied until backend exists)
🐝 Join the Hive — Run Your Own Bee
Your machine becomes a bee in the swarm. The hub handles registration, routing, and job distribution.
1. Install & start
curl -sSL https://hivv.org/install-hivv.sh | bash
hivv start
Registers your bee with the hub. Heartbeats every 60s.
2. Serve LLM & volunteer
hivv llm install
hivv llm serve
hivv volunteer on
Run ollama/llama.cpp. Your GPU power serves the hive.
3. Check your bee
hivv bees
# see all bees in the hive
hivv bee <name>
# inspect your bee
hivv drone
# your volunteer status
hivv waggle <name>
# test if another bee is reachable
hivv swarm "question"
# fan out to multiple models
How it works: LLM ports bind to localhost by default.
Use hivv firewall --apply to open to LAN or VPN peers.
Behind NAT/CGNAT? Use hivv volunteer on — the hub relays jobs through your long-poll inbox.
No port forwarding needed.
What does "model":"auto" do?
The router tries endpoints in this order: your own keys → local hardware (free, 64 tok/s) → peer nodes (via relay) → community key pool → cloud providers (OpenAI, Anthropic, etc.). Order is biased by measured speed (EWMA). Every response includes X-Hivv-Answered-By header showing which node/model answered.
1. Open Open WebUI Settings → Connections
2. Add OpenAI API:
- API Base URL: https://hivv.org/v1
- API Key: any
3. Select "auto" as the model
4. Start chatting — traffic routes through HIVV's distributed network
streaming: add "stream":true for real-time tokens
routing: add "route":{"mode":"fast"} for lowest latency