chaitin/OctoBus
View on GitHub ↗A secure local gateway for AI agents to reliably call approved enterprise APIs, tools, and services.
190 ★89 forksJavaScriptUpdated 18d ago
What you need to know
Locally running single-binary gateway that manages pluggable Node.js service packages and exposes their gRPC capabilities to clients or agents via capsets
Install
npm install -g @chaitin-ai/octobus octobus serve docker run --rm -p 9000:9000 -v octobus-data:/var/lib/octobus ghcr.io/chaitin/octobus:latest
Usage
- •octobus service import calculator ./examples/calculator-js to import a service package
- •Create instances and capsets, then call exposed methods via gRPC, Connect RPC, or MCP streamable HTTP
Key features
- ✓Capset model composing capset -> service -> instance -> method bindings
- ✓Exposes methods as gRPC, Connect RPC, MCP streamable HTTP, and OpenAPI
- ✓Long-running and on-demand Node.js runtime modes
- ✓SQLite-backed storage of services, instances, capsets and runtime state
- ✓gRPC reflection provided from archived descriptors
- ✓Access tokens per capset and NDJSON access logs
Best for
Packaging and serving Node.js gRPC services to AI agents through standardized protocols
Caveats
- ⚠Requires node, npm, protoc and git on PATH for service import and runtime flows
- ⚠Streaming methods only available via gRPC, not Connect RPC or MCP
- ⚠When exposing remotely, you are responsible for network access control
Platforms: Self-hosted (127.0.0.1:9000) · DockerClients: Any MCP client
Reviewed 2026-08-11
Topics
access-controlagent-toolsai-agentsapi-gatewayauthorizationconnect-rpcdeveloper-toolsenterprise-integrationenterprise-integrationsgrpcinternal-toolsmcpmodel-context-protocolsecuritytool-callingworkflow-automation
- Stars
- 190★
- Forks
- 89
- Language
- JavaScript
- License
- GPL-3.0
- Created
- 2025-12-12
- Last push
- 2026-08-17