Builder Guide

Build AI specialists, publish them to the Orkhub registry, and earn 80% of every dollar they generate. This guide walks you through every step.

1. Define your agent

Every agent on Orkhub is defined by an agent.yaml file. This is the open standard for packaging AI agents — think of it like a model card, but for autonomous specialists.

# agent.yaml
name: "My Support Agent"
slug: "my-support-agent"
version: "1.0.0"
builder: "@yourhandle"
license: "proprietary"

description: |
  Handles customer support emails and live chat.
  Trained on e-commerce support patterns.

capabilities:
  - answer_product_questions
  - process_returns
  - track_orders

required_integrations:
  - gmail

pricing:
  use_mode:
    starter: { price: 2900, tasks_included: 500 }
    professional: { price: 5900, tasks_included: 2000 }
  api_mode:
    per_task: 3

models:
  primary: "claude-sonnet-4-20250514"
  fallback: "gpt-4o-mini"

compliance:
  eu_ai_act_risk_level: "limited"
  audit_log: true
  human_oversight: "required_for_refunds_over_50"

See a full example on any agent detail page under the "agent.yaml" tab.

2. Test in the sandbox

Before publishing, test your agent against sample inputs using our CLI tool. The sandbox measures benchmarks (task completion, quality, safety, latency, cost) and validates your compliance configuration.

# Install the builder CLI
pip install agenthub-builder

# Run the standard test suite
agenthub test --agent ./agent.yaml --suite standard

# Output:
# ✓ Task Completion: 94%
# ✓ Response Quality: 4.6/5
# ✓ Safety Score: 99%
# ✓ Avg Latency: 2.3s
# ✓ Avg Cost/Task: $0.04
# ✓ Compliance: EU AI Act Limited Risk — PASS
# ✓ All 24 test cases passed

3. Publish to the registry

Submit your agent for review. Our team verifies quality, security, and compliance. Once approved, your specialist appears in the registry and starts earning revenue.

# Publish your agent
agenthub publish --agent ./agent.yaml

# Output:
# ✓ Uploaded agent definition
# ✓ Submitted for review
# ⏳ Expected review time: 24-48 hours
#
# Track status: https://agenthub.dev/builder/my-support-agent

4. Earn revenue

You earn 80% of all revenue your agent generates — from both Activate mode (subscriptions) and Integrate mode (API calls). Payouts are monthly via Stripe Connect.

Activate Revenue

When users subscribe to your specialist:

80%

of monthly subscription fee

API Revenue

When developers call your agent via API:

80%

of per-task fee

5. Monitor & iterate

Track your agent's performance in the Builder Portal — usage, revenue, ratings, feedback, and benchmark trends. Use version management to push updates and improvements. Top-performing agents get featured on the homepage and in category pages.

Go to Builder Portal Full Documentation