ECP Python SDK
Python SDK for building agents that comply with the Evaluation Context Protocol (ECP).
ECP is a vendor-neutral protocol for testing agent outputs, tool calls, and evaluator-visible audit context across frameworks, models, eval platforms, and CI systems.
Install
pip install "ecp-sdk==0.8.0"
Framework extras:
pip install "ecp-sdk[langchain]==0.8.0"
pip install "ecp-sdk[crewai]==0.8.0"
pip install "ecp-sdk[llamaindex]==0.8.0"
pip install "ecp-sdk[pydanticai]==0.8.0"
Usage
from ecp import Result, agent, on_step, serve
@agent(name="MyAgent")
class MyAgent:
@on_step
def step(self, user_input: str):
return Result(
public_output=f"Echo: {user_input}",
evaluation_context="Echoed the input for evaluation.",
tool_calls=[{"name": "echo", "arguments": {"text": user_input}}],
)
if __name__ == "__main__":
serve(MyAgent())
evaluation_context is the preferred field for evaluator-safe audit evidence. private_thought is still accepted as a deprecated compatibility alias.
Async lifecycle hooks
@on_step and @on_reset may be synchronous functions or async def coroutines. The SDK awaits async hooks on one persistent event loop, so loop-bound clients and other async resources can be reused across requests.
import asyncio
from ecp import Result, agent, on_reset, on_step, serve
@agent(name="AsyncAgent")
class AsyncAgent:
@on_step
async def step(self, user_input: str) -> Result:
await asyncio.sleep(0.01)
return Result(public_output=f"Processed: {user_input}")
@on_reset
async def reset(self) -> None:
await asyncio.sleep(0)
if __name__ == "__main__":
serve(AsyncAgent())
The same hooks work with serve_http(...). See examples/async_python_demo for a runnable agent that supports either transport.
Streamable HTTP
Agents can also run as an ECP Streamable HTTP server:
if __name__ == "__main__":
ecp.serve_http(MyAgent(), host="127.0.0.1", port=8765, path="/ecp")
The endpoint accepts JSON-RPC POST requests at /ecp. It returns JSON for requests, 202 Accepted for notifications, and 405 Method Not Allowed for GET SSE streams until ECP defines server-initiated messages.
Links
- Documentation: https://evaluationcontextprotocol.io/
- Repository: https://github.com/evaluation-context-protocol/ecp
- Issues: https://github.com/evaluation-context-protocol/ecp/issues
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ecp_sdk-0.8.0.tar.gz.
File metadata
- Download URL: ecp_sdk-0.8.0.tar.gz
- Upload date:
- Size: 15.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b43cc4a08a6b8e364bcc5dc3c7cb89a23b905ebcb86d5de2f5510288b1dd2775
|
|
| MD5 |
a892761bdd4006818a528fde56be3004
|
|
| BLAKE2b-256 |
c1082960d57d780f81c5a3c97af754c05c60cf6798cf754754dc68fb4b67d0d6
|
Provenance
The following attestation bundles were made for ecp_sdk-0.8.0.tar.gz:
Publisher:
release.yml on evaluation-context-protocol/ecp
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ecp_sdk-0.8.0.tar.gz -
Subject digest:
b43cc4a08a6b8e364bcc5dc3c7cb89a23b905ebcb86d5de2f5510288b1dd2775 - Sigstore transparency entry: 2525251220
- Sigstore integration time:
-
Permalink:
evaluation-context-protocol/ecp@bf6efccd83c83bc6b3c7dc7c63742e35a5ef0661 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/evaluation-context-protocol
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@bf6efccd83c83bc6b3c7dc7c63742e35a5ef0661 -
Trigger Event:
pull_request
-
Statement type:
File details
Details for the file ecp_sdk-0.8.0-py3-none-any.whl.
File metadata
- Download URL: ecp_sdk-0.8.0-py3-none-any.whl
- Upload date:
- Size: 15.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e0502db1a74d8020a763fe6896348521b8f88143e26011959a27d873f47e597a
|
|
| MD5 |
9fdc4bae452e889dbd8311aee765a116
|
|
| BLAKE2b-256 |
07e6dead39c922cf5ec45b8e8ad84369b1c09299757615b9deb3c0fa14ff8e27
|
Provenance
The following attestation bundles were made for ecp_sdk-0.8.0-py3-none-any.whl:
Publisher:
release.yml on evaluation-context-protocol/ecp
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ecp_sdk-0.8.0-py3-none-any.whl -
Subject digest:
e0502db1a74d8020a763fe6896348521b8f88143e26011959a27d873f47e597a - Sigstore transparency entry: 2525251427
- Sigstore integration time:
-
Permalink:
evaluation-context-protocol/ecp@bf6efccd83c83bc6b3c7dc7c63742e35a5ef0661 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/evaluation-context-protocol
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@bf6efccd83c83bc6b3c7dc7c63742e35a5ef0661 -
Trigger Event:
pull_request
-
Statement type:
