Skip to main content

Open-source Context OS for AI agents: auditable context engineering, compression, recovery, receipts, and verification.

Project description

Entroly

Entroly — The Open-Source Context OS for AI Agents

Keep your agent. Give it a Context OS.
The observability, governance, and decision layer for AI context.

Entroly is an open-source Context OS for AI agents: auditable context engineering, recoverable compression, memory, verification, provider controls, receipts, security, and guarded outcome learning in one local layer.

Install

pip install -U entroly

Run the local, no-key verification path:

entroly verify-claims
entroly simulate
entroly value

entroly value keeps provider-bound cost avoidance separate from SDK, MCP, and npm reductions. Local-only operations report tokens reduced with $0 claimed; modeled provider cost avoidance includes pricing provenance and is not a provider invoice.

MCP server

For an MCP client, register the installed entroly command with no arguments. When an MCP client launches it with a stdio pipe, Entroly starts the installed Python server directly:

entroly

Or register a package runner, also with no serve argument:

uvx --from entroly entroly
npx -y entroly-mcp

entroly serve is a different deployment path: it uses the Entroly Docker image by default. For the installed Python runtime in an interactive shell, use ENTROLY_NO_DOCKER=1 entroly serve on macOS/Linux or set ENTROLY_NO_DOCKER=1 in the client environment.

Entroly works with Claude Code, Codex, OpenClaw, GitHub Copilot in VS Code, Cursor, Windsurf, Cline, Continue, Zed, and other MCP-compatible clients.

GitHub Copilot / VS Code

Create .vscode/mcp.json:

{
  "servers": {
    "entroly": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", "entroly", "entroly"]
    }
  }
}

External MCP galleries can lag a release. Direct stdio registration above is the canonical setup; confirm a gallery entry's package version and validation status before relying on it.

Claude Code

claude mcp add entroly -- uvx --from entroly entroly

Generic MCP configuration

{
  "mcpServers": {
    "entroly": {
      "command": "uvx",
      "args": ["--from", "entroly", "entroly"]
    }
  }
}

What Entroly adds

  • Context selection under explicit token and cost budgets
  • Context Commits linking selected, omitted, and recoverable evidence
  • Context Receipts for replay, audit, and omission explanations
  • Exact recovery of compressed fragments through stable handles
  • Proof-guided recovery that verifies drafts, recovers exact omitted evidence, and stops under declared round/token bounds; local prepare and advance operations never call a provider
  • Local verification through WITNESS and receipt checks
  • Context Check coverage evidence for changed files and CI risk gates
  • Verified model-based dreaming (experimental, opt-in): real transitions train the model, synthetic rollouts only rank experiments, and real holdout evidence remains mandatory for promotion
  • Pure-Python base runtime, optional Rust acceleration, and a separate npm/WASM runtime
  • Local-first operation with no outbound analytics by default

Prepare a restart-safe model request without a provider call:

entroly proof prepare ./docs --query "What evidence supports this answer?" \
  --budget 8000 --idempotency-key request-001

The caller sends the returned request through its existing model route and returns the draft with entroly proof advance. See the repository's proof-guided protocol guide for MCP, proxy, and opt-in OpenClaw automation.

Links

MCP Registry identity

mcp-name: io.github.juyterman1000/entroly

Apache-2.0 licensed.

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

entroly-1.0.64.tar.gz (7.1 MB view details)

Uploaded Source

Built Distribution

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

entroly-1.0.64-py3-none-any.whl (1.2 MB view details)

Uploaded Python 3

File details

Details for the file entroly-1.0.64.tar.gz.

File metadata

  • Download URL: entroly-1.0.64.tar.gz
  • Upload date:
  • Size: 7.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for entroly-1.0.64.tar.gz
Algorithm Hash digest
SHA256 131f9b8488923bab434ecb368d12cb7020a890bc91c04e2963abe9a003a8b1d3
MD5 4ba519417a131bd477c1733fa4c3ad4a
BLAKE2b-256 10d9f8cf155b49478ff3713ec5496e68bda11b1491fa0eaf863583a9c17efcda

See more details on using hashes here.

File details

Details for the file entroly-1.0.64-py3-none-any.whl.

File metadata

  • Download URL: entroly-1.0.64-py3-none-any.whl
  • Upload date:
  • Size: 1.2 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for entroly-1.0.64-py3-none-any.whl
Algorithm Hash digest
SHA256 30cc40a29e880f389af54e54cda712a5047b9e03ccdb8c8eb794a5ea2a1bf8e0
MD5 faffe0986b80a127dba854f9edbbd9ba
BLAKE2b-256 83aa380a0564ecd0c81f3fa77f1ab22fc96f5625aae3a23bd3040d4abe33eb49

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