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.63.tar.gz (21.9 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.63-py3-none-any.whl (1.1 MB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for entroly-1.0.63.tar.gz
Algorithm Hash digest
SHA256 c259fe1e25311679f54ef356f14047f3f6c1e1a6943e82c27bc00966fcea1a3f
MD5 d718851d03a172363008468001804f15
BLAKE2b-256 eceebe903ef76e90171f179dc1754c896bdd6a0543bb01b233f8f642f91df6fd

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for entroly-1.0.63-py3-none-any.whl
Algorithm Hash digest
SHA256 275f4a522a127f2354b1311aba2c556539d706a640219076a1ef7c56f01c89a9
MD5 d81c8bc59d3fe402fab3c5d88801a6cc
BLAKE2b-256 08df9f915acf495aa19ebc75a5ccbdf613b9b6768b2f646c1d05242767577439

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