AgentConnect is the multi-language SDK and reference implementation for the Agent Network Protocol (ANP). It helps agents identify each other, publish discoverable interfaces, call each other over standard RPC, attach verifiable proofs, resolve human-readable handles, and build end-to-end encrypted communication flows.
The Python package name is anp; this repository also contains Go, Rust, Dart, TypeScript, and Java SDK implementations or SDK workspaces.
ANP is a protocol stack for an open network of interoperable agents. In practice, it answers these questions:
- Who am I talking to? DID WBA identities, DID documents, HTTP Message Signatures, and verifier helpers.
- What can this agent do? Agent Description documents, OpenRPC interface documents, and JSON-RPC endpoints.
- Can I trust this object or request? W3C Data Integrity proofs, Appendix-B object proofs, IM/origin proofs, and DID-WBA binding proofs.
- How do humans and agents find each other? WNS handle validation, resolution, and binding verification.
- How do agents communicate privately? Direct and group E2EE building blocks used by ANP-compatible clients and services.
- Python agent SDK: OpenANP for quickly building and calling ANP agents, plus authentication, proof, WNS, AP2, crawler, and E2EE modules.
- Shared protocol SDKs: Go and Rust cover core ANP identity/proof/WNS functionality plus selected E2EE surfaces; Dart focuses on core identity, proof, and WNS helpers.
- Preview/local SDK workspaces: TypeScript and Java implementations that can be used from source while their public package status matures.
- Examples and fixtures: runnable examples, cross-language interop checks, and shared test vectors.
- Release tooling: coordinated Python / Go / Rust release workflow and version policy.
| I want to... | Start here |
|---|---|
| Build a working ANP agent quickly | Python OpenANP quick start |
| Add DID WBA authentication to an HTTP service | DID WBA examples |
| Use the latest stable SDK release | SDKs and releases |
| Call or crawl another ANP agent | ANP Crawler examples |
| Work with proofs, WNS, or E2EE | Core concepts and examples |
| Contribute to the repository | Development |
- SDKs and releases
- Quick start: build a Python agent
- Examples by learning path
- Core concepts
- Repository map
- Development
- Release and versioning
- Security and compatibility notes
- Contact us
- License
Registry status checked on 2026-06-27. Python, Go, and Rust are the coordinated stable release line in this repository. Dart is published separately. TypeScript and Java are usable from source/local builds, but this README does not claim public npm or Maven Central publication for them.
| Language | Package / module | Where to get it | Checked version | Install / use | Examples | Status |
|---|---|---|---|---|---|---|
| Python | anp |
PyPI | 0.8.8 |
pip install anp or pip install "anp[api]" for OpenANP/FastAPI extras |
examples/python/ | Stable published SDK |
| Go | github.com/agent-network-protocol/anp/golang |
Go module proxy / pkg.go.dev | v0.8.8 |
go get github.com/agent-network-protocol/anp/golang@latest |
golang/examples/ | Stable published SDK; tag format is golang/vX.Y.Z |
| Rust | anp |
crates.io / docs.rs | 0.8.8 |
cargo add anp |
rust/examples/ | Stable published SDK |
| Dart | anp |
pub.dev | 0.8.7 |
dart pub add anp |
dart/example/ | Published SDK; versioned outside the current Python/Go/Rust release helper |
| TypeScript | @anp/typescript-sdk |
Source workspace | local 0.1.0 |
cd typescript/ts_sdk && npm install && npm run build |
typescript/ts_sdk/examples/ | Preview/local source; npm registry check returned not found |
| Java | com.agentconnect:anp4j, com.agentconnect:anp-spring-boot-starter |
Local Maven build | local 1.0.0 |
cd java && mvn clean install -DskipTests |
java/anp-examples/ | Local SDK; Maven Central metadata check returned not found |
# Python core SDK
pip install anp
# Python agent-building extras: FastAPI + OpenAI dependencies
pip install "anp[api]"
# Go
go get github.com/agent-network-protocol/anp/golang@latest
# Rust
cargo add anp
# Dart
dart pub add anpFor local repository development, prefer the commands in Development instead of installing published packages.
OpenANP is the fastest way to see ANP in action. It turns ordinary Python methods into discoverable ANP interfaces and exposes the standard agent documents and JSON-RPC endpoint.
Install the API extras if you are using the published package:
pip install "anp[api]"When developing from this repository, use:
uv sync --extra apiCreate app.py:
from fastapi import FastAPI
from anp.openanp import AgentConfig, anp_agent, interface
@anp_agent(AgentConfig(
name="Calculator",
did="did:wba:example.com:calculator",
prefix="/agent",
description="A simple calculator agent",
))
class CalculatorAgent:
@interface
async def add(self, a: int, b: int) -> int:
return a + b
app = FastAPI(title="Calculator Agent")
app.include_router(CalculatorAgent.router())Run the server:
uvicorn app:app --port 8000OpenANP generates these ANP endpoints automatically:
| Endpoint | Purpose |
|---|---|
GET /agent/ad.json |
Agent Description document for discovery |
GET /agent/interface.json |
OpenRPC interface document generated from Python type hints |
POST /agent/rpc |
JSON-RPC 2.0 endpoint for method calls |
Call it with the repository example client:
uv run python examples/python/openanp_examples/minimal_client.pyFull runnable pair:
# Terminal 1
uvicorn examples.python.openanp_examples.minimal_server:app --port 8000
# Terminal 2
uv run python examples/python/openanp_examples/minimal_client.py| Level | Goal | Start here | Notes |
|---|---|---|---|
| Beginner | Build and call an ANP agent | examples/python/openanp_examples/ | Requires the api optional dependencies. |
| Beginner | Create and verify DID WBA identity | examples/python/did_wba_examples/ | Offline examples are a good first auth smoke test. |
| Beginner | Generate and verify proofs | examples/python/proof_examples/ | Covers W3C/Data Integrity and ANP proof helpers. |
| Beginner | Validate and resolve WNS handles | examples/python/wns_examples/ | Some resolution flows require network access or a local resolver. |
| Intermediate | Discover ANP documents and execute tools | examples/python/anp_crawler_examples/ | Crawler-style interface discovery and JSON-RPC execution. |
| Intermediate | Run AP2 payment protocol flow | examples/python/ap2_examples/ | Merchant/shopper mandate examples. |
| Intermediate | Check Python ↔ Rust interoperability | examples/python/rust_interop_examples/ | Useful when touching auth or wire fixtures. |
| Advanced | Explore Direct E2EE examples | examples/python/e2e_encryption_hpke_examples/ and docs/e2e/direct-e2ee-p5-sdk.md | Use current P5 docs for product-facing direct E2EE behavior. |
| Advanced | Explore Group E2EE / MLS | docs/e2e/group-e2ee-p6-anp-mls.md | Group E2EE is security-sensitive; follow the documented boundaries. |
| Advanced | Try LLM-assisted protocol negotiation | examples/python/negotiation_mode/ | Requires .env LLM provider configuration. |
Language-specific examples are also available in golang/examples/, rust/examples/, dart/example/, typescript/ts_sdk/examples/, and java/anp-examples/.
| Concept | What it means in this repository | Learn more |
|---|---|---|
| DID WBA | Web-based decentralized identifiers, DID documents, verification methods, HTTP Message Signatures, and auth verifier helpers. | examples/python/did_wba_examples/ |
| Agent Description | The ad.json document that lets another agent discover who you are and where your interfaces live. |
examples/python/openanp_examples/ |
| OpenRPC / JSON-RPC | Interface schema and method-call transport generated from Python type hints by OpenANP. | anp/openanp/ |
| Proof | W3C Data Integrity, Appendix-B object proof, group receipt, DID-WBA binding, IM, and RFC 9421 origin proof helpers. | examples/python/proof_examples/ |
| WNS | WBA Name Space helpers for human-readable handles, wba:// URIs, resolution, and DID binding verification. |
examples/python/wns_examples/ |
| Direct E2EE | ANP-P5 private-chat E2EE models, session state, prekey handling, and shared vectors across SDKs. | docs/e2e/direct-e2ee-p5-sdk.md |
| Group E2EE | ANP-P6 group E2EE / MLS operation surfaces and local-state boundaries. | docs/e2e/group-e2ee-p6-anp-mls.md |
| AP2 | Agent Payment Protocol v2 mandate models and validation helpers. | examples/python/ap2_examples/ |
| Legacy / specialized modules | FastANP, older E2EE examples, and meta-protocol negotiation remain available for compatibility or advanced experiments. | examples/python/fastanp_examples/, examples/python/e2e_encryption_v2_examples/, examples/python/negotiation_mode/ |
| Path | Purpose |
|---|---|
| anp/ | Python package: OpenANP, authentication, proof, WNS, AP2, crawler, E2EE, and meta-protocol modules. |
| examples/python/ | Python examples grouped by feature and learning path. |
| golang/ | Pure Go ANP SDK module and examples. |
| rust/ | Rust anp crate, examples, tests, and MLS/E2EE operation surfaces. |
| dart/ | Dart SDK package, examples, tests, and Flutter smoke workspace. |
| typescript/ts_sdk/ | TypeScript SDK preview workspace for Node 20+. |
| java/ | Java SDK modules: core anp4j, Spring Boot starter, and examples. |
| docs/ | Protocol-adjacent docs for DID, AP2, E2EE, public fixtures, and PR notes. |
| testdata/ | Shared cross-language fixtures and vectors. |
| skills/anp-multilang-release/ | Coordinated Python / Go / Rust release helper and policy. |
Use the toolchain for the language you are changing. Common local commands:
# Python
uv sync
uv sync --extra api # OpenANP / FastAPI examples
uv sync --extra dev # pytest and development tools
uv run pytest
uv build --wheel
# Go
cd golang
go test ./...
# Rust
cd rust
cargo test
# Dart
cd dart
dart pub get
dart analyze
dart test
# TypeScript preview workspace
cd typescript/ts_sdk
npm install
npm run typecheck
npm test
npm run build
# Java local workspace
cd java
mvn testSome examples require network access or .env configuration, especially LLM-assisted negotiation examples under examples/python/negotiation_mode/.
Python, Go, and Rust use one coordinated X.Y.Z version managed by skills/anp-multilang-release/. The release policy is documented in skills/anp-multilang-release/references/release-policy.md.
Current coordinated release files include:
- Python package version in pyproject.toml and runtime version in anp/init.py.
- Rust crate version in rust/Cargo.toml.
- Go runtime version in golang/version.go.
Tag rules:
- Root release tag:
X.Y.Z, for example0.8.8. - Go submodule tag:
golang/vX.Y.Z, for examplegolang/v0.8.8.
Release planning starts with:
uv run python skills/anp-multilang-release/scripts/release.py plan --version 0.8.8The release command validates the working tree, aligned version files, Python build, Rust dry-run publish, and Go tests before publishing and pushing tags.
- Load secrets from
.envor runtime configuration; never hardcode real private keys or tokens. - Treat DID private keys, E2EE key material, and decrypted plaintext as sensitive local data.
- Prefer current DID WBA and HTTP Message Signature flows for new integrations; legacy modules remain documented for compatibility.
- Do not assume preview/local SDK workspaces are already published packages unless the README explicitly says so.
- Author: GaoWei Chang
- Email: chgaowei@gmail.com
- Website: https://agent-network-protocol.com/
- Discord: https://discord.gg/sFjBKTY7sB
- GitHub: https://github.com/agent-network-protocol/AgentNetworkProtocol
- WeChat: flow10240
This project is open-sourced under the MIT License. See LICENSE for details.
Copyright (c) 2024 GaoWei Chang