Skip to main content

Sovereign external API proxy with TIBET provenance — egress control, intent verification, host allowlist

Project description

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

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

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

Environment variable Description Default
TIBET_GATEWAY_ALLOWED_HOSTS Comma-separated list of allowed domains empty (block all)

Part of the TIBET ecosystem


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

License

MIT

Credits

Designed by Jasper van de Meent. Built by Jasper and Root AI as part of HumoticaOS.


Stack-positie: Groep agentic · Bootstrap = OSAPI-handshake naar tibet + jis (fail → snaft-rule + tibet-pol-rapport) · ← ainternet · tibet-triage → · See STACK.md · See demo/golden-path/ for the spine end-to-end.

Enterprise

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

Enterprise enterprise@humotica.com
Support support@humotica.com
Security security@humotica.com

See ENTERPRISE.md for details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tibet_gateway-0.3.1.tar.gz (15.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

tibet_gateway-0.3.1-py3-none-any.whl (9.9 kB view details)

Uploaded Python 3

File details

Details for the file tibet_gateway-0.3.1.tar.gz.

File metadata

  • Download URL: tibet_gateway-0.3.1.tar.gz
  • Upload date:
  • Size: 15.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for tibet_gateway-0.3.1.tar.gz
Algorithm Hash digest
SHA256 64ed2022ca8248d8a8557ec5e1521f07fd77aa2842526ae9750b58c59b9925bf
MD5 2a6a4438bd3f6d4220ab0dfcc1bf4bca
BLAKE2b-256 5b2a037dcb87b0a8d21e22d54020029a21c172a1294109af291489f1faeffbbb

See more details on using hashes here.

File details

Details for the file tibet_gateway-0.3.1-py3-none-any.whl.

File metadata

  • Download URL: tibet_gateway-0.3.1-py3-none-any.whl
  • Upload date:
  • Size: 9.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for tibet_gateway-0.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 122a5f37fc154a30211e5cfe934a516fcd2d5f57a08a10b02c1f15a1a4d42fa0
MD5 45b73b5b0fcd138ca02a9d198d702444
BLAKE2b-256 47dae400677f2c510c5edd94c021d96fcd5b3e4546c7086549d51288ad48dd19

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page