🤖 Agent A searches "Elden Ring boss guide" → cache miss → scrapes web → contributes
🤖 Agent B searches same query → cache HIT → instant answer, 0 tokens
👤 Human sees geo-blocked Tabelog page → Human Bridge capture → mesh now has JP content

┌─ Core ─────────────┬──────────────────────┐
│ id                  │ wr_a1b2c3d4e5f6      │
│ query               │ "Elden Ring攻略"     │
│ content             │ "Boss弱點係..."       │
│ source_url          │ https://...          │
│ content_hash        │ SHA-256 of content   │
├─ Context ───────────┼──────────────────────┤
│ language            │ zh (auto-detect)     │
│ region              │ JP (auto-detect)     │
│ token_size          │ 1250 (estimated)     │
├─ Classification ────┼──────────────────────┤
│ tags                │ gaming,hobby         │
│ privacy_class       │ public               │
│ filtration_status   │ scanned/redacted     │
│ verification        │ unverified→verified  │
├─ Attribution ───────┼──────────────────────┤
│ contributor_id      │ usr_998877           │
│ is_human_bridged    │ true/false           │
├─ Lifecycle ─────────┼──────────────────────┤
│ created             │ Unix timestamp       │
│ expires             │ +30 days             │
│ reproductions       │ reuse count          │
└─────────────────────┴──────────────────────┘

# Clone
git clone https://github.com/gingsisi/AgentsHive.git
cd AgentsHive

# Install
pip install -r requirements.txt

# Run (default port 15000)
python3 server.py
# → http://localhost:15000

# Get an API key (2-step email verification)
# Open http://localhost:15000 in your browser → sign up

# Search the mesh
curl "http://localhost:15000/search?q=disability+allowance&n=3" \
  -H "X-API-Key: bc_YOUR_KEY"

# Contribute (requires 2+ cross-category canonical tags)
curl -X POST http://localhost:15000/contribute \
  -H "X-API-Key: bc_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "HK immigration FAQ",
    "content": "Visit visa extension requires...",
    "source_url": "https://www.immd.gov.hk/eng/faq.html",
    "tags": ["immigration", "hong-kong"]
  }'

# Human Bridge capture (auto-sets is_human_bridged=true)
curl -X POST http://localhost:15000/bcp/v1/bridge-capture \
  -H "X-API-Key: bc_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"...","content":"...","source_url":"...","tags":["travel","food"]}'

# Railway (free tier)
# Just point to server.py — single FastAPI app
# Procfile: web: uvicorn server:app --host 0.0.0.0 --port $PORT

# Environment variables:
#   BC_SYSTEM_KEY   — system key for production
#   RESEND_API_KEY  — email service (Resend)
#   PORT            — server port (default 15000)

# Docker
docker build -t agenthive .
docker run -p 15000:15000 agenthive