BIGHUB

Decision learning for AI agents.

BIGHUB is a decision layer that evaluates agent actions, returns structured recommendations, and learns from real outcomes over time.

Agent proposes action
        ↓
BIGHUB evaluates in context
        ↓
returns recommendation + confidence + rationale
        ↓
agent / runtime decides what to do
        ↓
real outcome is reported
        ↓
future recommendations improve over time

Packages

How it works

Quickstart (Python SDK)

pip install bighub

import os
from bighub import BighubClient

client = BighubClient(api_key=os.getenv("BIGHUB_API_KEY"))

# 1. Submit an action for evaluation
result = client.actions.submit(
    action="update_price",
    value=150.0,
    domain="pricing",
    actor="AI_AGENT_001",
)

# 2. Inspect the recommendation
print(result["recommendation"])             # proceed, proceed_with_caution, review_recommended, do_not_proceed
print(result["recommendation_confidence"])   # high, medium, low
print(result["risk_score"])                  # 0.0 – 1.0

# 3. Act based on the recommendation
if result["recommendation"] in ("proceed", "proceed_with_caution"):
    execute_action()

    # 4. Report the real outcome
    client.outcomes.report(
        request_id=result["request_id"],
        status="SUCCESS",
        description="Price updated, no negative impact observed",
    )
elif result["recommendation"] == "review_recommended":
    request_human_review()

client.close()

Core loop: evaluate → recommend → act → report outcome → learn.

Structured recommendation

BIGHUB primarily returns:

• recommendation — what to do (proceed, proceed_with_caution, review_recommended, do_not_proceed)
• recommendation_confidence — how confident (high, medium, low)
• risk_score — aggregated risk (0–1)
• enforcement_mode — how the recommendation is applied (advisory, review, enforced)
• decision_intelligence — rationale, evidence status, trajectory health, alternatives

Legacy fields such as allowed, result, and reason may still appear for backward compatibility, but they are not the primary product surface.

Trajectory-aware evaluation

BIGHUB evaluates actions not only in isolation, but also in the context of what happened before. As outcomes accumulate, similar sequences and prior decisions improve future recommendations.

For costly and multi-step workflows, trajectory-aware signals mean the same action may be judged differently depending on what happened earlier in the sequence.

Free BETA

Current Free BETA limits:

• 3 agents
• 2,500 actions / month
• 30 days history
• 1 environment

Repository layout

├── sdk/
│   └── python/
├── adapters/
│   ├── python/
│   │   ├── openai/
│   │   └── anthropic/
│   └── js/
│       └── openai/
├── servers/
│   └── mcp/
└── examples/

Links

• bighub.io
• GitHub — bighub-io/bighub
• PyPI — bighub
• PyPI — bighub-openai
• npm — @bighub/bighub-mcp

License

MIT