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.6.tar.gz (530.2 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.6-py3-none-any.whl (461.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: atlast_ecp-0.32.6.tar.gz
  • Upload date:
  • Size: 530.2 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.6.tar.gz
Algorithm Hash digest
SHA256 13e13f287f632956b52fb388be3adf6248d503687ecbfd54b6cccdf2a7075314
MD5 7a1fb49e7bd90efc56b0a34c87ccb98d
BLAKE2b-256 8070cba707638f9bc573b93de19f890ae8f806d0efb08ffc4952a8b814415864

See more details on using hashes here.

File details

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

File metadata

  • Download URL: atlast_ecp-0.32.6-py3-none-any.whl
  • Upload date:
  • Size: 461.3 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.6-py3-none-any.whl
Algorithm Hash digest
SHA256 aec4935dd411375e704c6cc4d7f6f17293f33a3a6e680a1b5a09242b280d6c81
MD5 2bf854e9646897ff2b0249a71547f0c9
BLAKE2b-256 2f2a63700e39c83d701df62c0dff9ed4af3b1586f93bb5e00b0058387e456188

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