tibet-gateway

Alpha -- API may change between versions.

Sovereign external API proxy with TIBET provenance. Routes all AI agent egress traffic through a single gateway with host allowlist, intent verification (SNAFT), and provenance sealing.

Install

pip install tibet-gateway

Quick start

1. Configure allowed hosts (safe default: block all)

export TIBET_GATEWAY_ALLOWED_HOSTS=api.openai.com,api.anthropic.com
export TIBET_GATEWAY_EVENT_LOG=/var/log/tibet/gateway.jsonl

2. Start the gateway

tibet-gateway serve --port 8080

3. Proxy a call

curl -X POST http://localhost:8080/proxy \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "my-bot.aint",
    "intent": "summarize_text",
    "target_url": "https://api.openai.com/v1/chat/completions",
    "method": "POST",
    "payload": {"model": "gpt-4", "messages": [{"role": "user", "content": "Hello"}]}
  }'

The response includes the original API response plus a TIBET seal with full provenance.

4. Check stats

tibet-gateway stats
tibet-gateway events --limit 10

What happens on each call

1. Host check -- target domain must be in TIBET_GATEWAY_ALLOWED_HOSTS
2. TIBET envelope -- mint provenance token (actor, intent, timestamp)
3. SNAFT check -- verify payload matches declared intent
4. Identity headers -- attach AINS identity and TBZ signature
5. Proxy -- forward to external API
6. Seal -- wrap response with TIBET seal and log stats

Configuration

Structured Event Log

Besides TIBET token chains, tibet-gateway can emit a JSONL event lane for operational governance and AI-SBOM ingestion.

Each event records:

• actor / agent identity
• provider
• model
• target URL
• route class
• TIBET envelope / seal references
• status and latency

This is the live Tier B source that tibet-ai-sbom can ingest as observation_layer = tibet-gateway.

Part of the TIBET ecosystem

• tibet -- core provenance tokens
• tibet-airlock -- sandbox execution
• tibet-mux -- channel multiplexing

Authors: Jasper van de Meent, Gemini & Root AI (Humotica AI fAmIly) License: MIT

Enterprise

For private hub hosting, SLA support, custom integrations, or compliance guidance:

See ENTERPRISE.md for details.