Skip to main content

Transparent HTTP proxy for AI agents. Sees everything SDK cannot — cross-agent patterns, fleet anomalies, duplicate context. Zero code changes. MIT license.

Project description

PyPI Tests License Stars Dependencies

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.

Get Started MCP Scanner Website

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:

→ orchesis.io/scan

Or via CLI:

orchesis audit-openclaw

Contributing

Note: dashboard/dist/ is intentionally committed for zero-setup deployment. Run npm run build in dashboard/ to rebuild from source.

Website · Documentation · MCP Scanner · Blog

MIT License · Built with ❤️ and zero dependencies

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

orchesis-0.1.3.tar.gz (846.6 kB view details)

Uploaded Source

Built Distribution

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

orchesis-0.1.3-py3-none-any.whl (651.7 kB view details)

Uploaded Python 3

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

Hashes for orchesis-0.1.3.tar.gz
Algorithm Hash digest
SHA256 a201f79ca766230d7ee0f61fcbbb34ca8bed8e74266c8ce46b1a6e78536683d0
MD5 a26a2b15fcee9d038fe9c44bc2f4ad35
BLAKE2b-256 ead251e8b57da57cba4f210c3c1c50835b301fed3680b150fd5efc409cc828c2

See more details on using hashes here.

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

Hashes for orchesis-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 d0e20c19bfb400ee0d91b3ee80db4e9153a726f91b136a19e7866fe77aaa9dba
MD5 8c17ea20f746083ac7c0812b8bcae748
BLAKE2b-256 27695465c1e1ecd1ede1d24f6ddc38bac70109861ed4e02a6fb768c2dad71f96

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