Skip to main content

ATLAST Evidence Chain Protocol — trust infrastructure for AI Agents

Project description

atlast-ecp

Python SDK for the ATLAST Evidence Chain Protocol (ECP) — trust infrastructure for AI agents.

PyPI Tests Python License

Install

One-liner (handles Homebrew Python, venvs, PEP 668 distros automatically):

# macOS / Linux
curl -sSL https://weba0.com/install.sh | bash

# Windows (PowerShell)
irm https://weba0.com/install.ps1 | iex

Or install manually:

# Default — works on Homebrew / system Python / locked-down distros
pip install --user atlast-ecp

# Inside a venv or conda env — drop the --user flag:
pip install atlast-ecp

# Extras
pip install --user atlast-ecp[crypto]   # ed25519 signing
pip install --user atlast-ecp[proxy]    # transparent proxy (Layer 0)
pip install --user atlast-ecp[all]      # everything

Why --user? Modern macOS Homebrew Python and Debian 12 / Ubuntu 23+ enforce PEP 668 and reject plain pip install with externally-managed-environment. --user installs to your user site-packages and bypasses the restriction on every platform. If you're already inside a virtualenv, you don't need --user.

Three Integration Layers

Layer 0 — Zero Code (transparent proxy)

atlast run python my_agent.py
# or: OPENAI_BASE_URL=http://localhost:8340 python my_agent.py

Layer 1 — One Line (wrap)

from atlast_ecp import wrap
from openai import OpenAI

client = wrap(OpenAI())  # Records every LLM call automatically
response = client.chat.completions.create(model="gpt-4o", messages=[...])

Works with: OpenAI, Anthropic, Google Gemini, LiteLLM.

Layer 2 — Framework Adapters

# LangChain
from atlast_ecp.adapters.langchain import ATLASTCallbackHandler
llm = ChatOpenAI(callbacks=[ATLASTCallbackHandler(agent="my-agent")])

# CrewAI
from atlast_ecp.adapters.crewai import ATLASTCrewCallback
crew = Crew(callbacks=[ATLASTCrewCallback(agent="my-crew")])

# AutoGen
from atlast_ecp.adapters.autogen import register_atlast
register_atlast(my_agent)

CLI

atlast init              # Initialize ~/.ecp/
atlast record            # Create ECP record
atlast log               # View latest records
atlast verify <id>       # Verify chain integrity
atlast stats             # Trust signals
atlast insights          # Performance analytics
atlast proxy             # Start transparent proxy
atlast run <cmd>         # Run with auto-proxy
atlast did               # Agent DID

Module Stability

Module Status Description
core 🟢 Stable record_minimal(), record()
wrap 🟢 Stable wrap(client) for OpenAI/Anthropic/Gemini
record 🟢 Stable ECP record creation (v1.0 spec)
batch 🟢 Stable Merkle tree + batch upload
verify 🟢 Stable Signature + Merkle proof verification
storage 🟢 Stable Local ~/.ecp/ file storage
signals 🟢 Stable Trust signal computation
identity 🟢 Stable DID + Ed25519 key management
config 🟢 Stable Environment/config management
insights 🟢 Stable Performance analytics
webhook 🟢 Stable HMAC-signed webhook delivery
adapters.* 🟢 Stable LangChain, CrewAI, AutoGen
proxy 🟡 Beta Transparent HTTP proxy (Layer 0)
a2a 🟡 Beta Agent-to-Agent handoff tracking
cli 🟡 Beta atlast CLI
mcp_server 🟠 Experimental MCP tools server
otel_exporter 🟠 Experimental OpenTelemetry exporter
openclaw_scanner 🟠 Experimental OpenClaw session log scanner
auto 🟠 Experimental OTel auto-instrumentation

Privacy

  • Content never leaves your device — only SHA-256 hashes transmitted
  • Local storage: ~/.ecp/records/
  • On-chain: Merkle root only (EAS on Base)
  • Fail-Open: SDK errors never crash your agent

Links

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

atlast_ecp-0.32.7.tar.gz (530.3 kB view details)

Uploaded Source

Built Distribution

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

atlast_ecp-0.32.7-py3-none-any.whl (461.5 kB view details)

Uploaded Python 3

File details

Details for the file atlast_ecp-0.32.7.tar.gz.

File metadata

  • Download URL: atlast_ecp-0.32.7.tar.gz
  • Upload date:
  • Size: 530.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.6

File hashes

Hashes for atlast_ecp-0.32.7.tar.gz
Algorithm Hash digest
SHA256 e77707568095f76e55dd65d020049d9cb31bfafad7a1ecbfac6bb44d31b7f00e
MD5 10731100f33f4e8cf79d60c9263c32e3
BLAKE2b-256 a6e4167d964cdb54f7f460736485f8ab8134c9574c45544b57f35c9c0f7f7f48

See more details on using hashes here.

File details

Details for the file atlast_ecp-0.32.7-py3-none-any.whl.

File metadata

  • Download URL: atlast_ecp-0.32.7-py3-none-any.whl
  • Upload date:
  • Size: 461.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.6

File hashes

Hashes for atlast_ecp-0.32.7-py3-none-any.whl
Algorithm Hash digest
SHA256 047729c6b8ec7c8efe2f8155ec01bacf43ef9a8298144ca0c62fdb3c71d475fc
MD5 11ad27abbde5b3b143dc179ed91c0146
BLAKE2b-256 6419e8cc5675a971a57717985189a3b9167f5f3691caa2633aca0e3c23a1da0c

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