Transparent HTTP proxy for AI agents. Sees everything SDK cannot — cross-agent patterns, fleet anomalies, duplicate context. Zero code changes. MIT license.
Project description
Orchesis is a transparent HTTP proxy between AI agents and LLM APIs. Every request passes through a 17-phase detection pipeline. Zero dependencies. MIT license. AI Agent -> [Orchesis: 17 phases] -> LLM Provider (OpenAI, Anthropic...)
SDK sees one agent. Static analysis sees code. Observability sees metrics.
Proxy sees everything — in real time, without code changes.
Installation
# Core (zero dependencies)
pip install orchesis
# With integrations (Slack, Telegram, webhooks)
pip install orchesis[integrations]
orchesis quickstart --preset openclaw
One line change:
# Before:
client = OpenAI(base_url="https://api.openai.com/v1")
# After:
client = OpenAI(base_url="http://localhost:8080/v1")
# ↑ 17 security phases now active
How it works
graph LR
A[AI Agent<br/>OpenClaw/CrewAI/LangChain] -->|HTTP request| B
B[Orchesis Proxy<br/>17-phase pipeline<br/>localhost:8080] -->|filtered request| C
C[LLM Provider<br/>OpenAI/Anthropic/Google]
B --> D[Dashboard<br/>Metrics & Alerts]
Why proxy, not SDK?
| Approach | What it sees | Code changes needed |
|---|---|---|
| SDK/callbacks (LangSmith, LangChain) | One agent, one session | Yes — integrate per agent |
| Static analysis (Snyk, Semgrep) | Code at rest | Yes — add to CI pipeline |
| Observability (Datadog, Helicone) | Metrics and logs | Yes — instrument code |
| Orchesis proxy | All agents, all requests, cross-session patterns | No — one config line |
The proxy layer sees what SDK cannot: cross-agent patterns, fleet-level anomalies, duplicate context across providers. This is an architectural advantage, not a feature difference.
What Orchesis does
| Security | Cost | Reliability | Observability | |
|---|---|---|---|---|
| 17-phase detection. Prompt injection, credential leaks, tool abuse. 25 signatures. | Context compression 80-90%. Semantic cache. Thompson Sampling routing. | Auto-healing. Circuit breakers. Loop detection. 6 recovery actions. | Real-time dashboard. Flow X-Ray. Agent Reliability Score. |
By the numbers
| Metric | Value |
|---|---|
| Pipeline phases | 17 |
| Threat signatures | 25 across 10 categories |
| Token savings | 80-90% |
| MAST coverage | 78.6% |
| OWASP coverage | 80% |
| Auto-heal actions | 6 |
| Tests passing | 2,969 |
| Dependencies | 0 (stdlib only) |
- MVE result: 0.8% proxy overhead. 12x context collapse detected without proxy.
- Zero external dependencies — no vendor lock-in, no data leaves your infrastructure
Free MCP Security Scanner
Check your MCP configuration for security issues:
Or via CLI:
orchesis audit-openclaw
Contributing
Note:
dashboard/dist/is intentionally committed for zero-setup deployment. Runnpm run buildindashboard/to rebuild from source.
Website · Documentation · MCP Scanner · Blog
MIT License · Built with ❤️ and zero dependencies
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file orchesis-0.1.3.tar.gz.
File metadata
- Download URL: orchesis-0.1.3.tar.gz
- Upload date:
- Size: 846.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.10
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a201f79ca766230d7ee0f61fcbbb34ca8bed8e74266c8ce46b1a6e78536683d0
|
|
| MD5 |
a26a2b15fcee9d038fe9c44bc2f4ad35
|
|
| BLAKE2b-256 |
ead251e8b57da57cba4f210c3c1c50835b301fed3680b150fd5efc409cc828c2
|
File details
Details for the file orchesis-0.1.3-py3-none-any.whl.
File metadata
- Download URL: orchesis-0.1.3-py3-none-any.whl
- Upload date:
- Size: 651.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.10
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d0e20c19bfb400ee0d91b3ee80db4e9153a726f91b136a19e7866fe77aaa9dba
|
|
| MD5 |
8c17ea20f746083ac7c0812b8bcae748
|
|
| BLAKE2b-256 |
27695465c1e1ecd1ede1d24f6ddc38bac70109861ed4e02a6fb768c2dad71f96
|