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: The Java implementation can be used from source while its 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.
ANP-04 WNS 1.1 makes binding_generation a required security field. Support for
that stricter contract is intentionally being introduced per language rather
than implied by the repository's shared package version.
| SDK | Required canonical binding_generation | Handle-rebind P6 primitives | Status |
|---|---|---|---|
| Python | Implemented | Not applicable; Python has no OpenMLS surface | Supported for this change |
| Rust | Implemented | Existing group.e2ee.add / group.e2ee.remove typed primitives accept the same GroupStateRef | Supported for this change |
| Go | Implemented | Contract/provider surface only; no in-process OpenMLS status API | Shared conformance vectors pass |
| Dart | Implemented | Not applicable; Dart has no Group E2EE/OpenMLS surface | Shared conformance vectors pass |
| Java | Not applicable; Java has no WNS surface | Not applicable; Java has no Group E2EE/OpenMLS surface | No corresponding API to synchronize |
| TypeScript | Implemented | Not applicable; TypeScript has no Group E2EE/OpenMLS surface | Shared conformance vectors pass |
The release helper coordinates Python, Rust, and Go under one version. Release claims must still distinguish WNS generation conformance from Rust's in-process OpenMLS rebind and status capabilities.
| I want to... | Start here |
|---|---|
| Build a working ANP agent quickly | Python OpenANP quick start |
| Create an e1 DID and run complete authentication | Python e1 authentication example |
| Add DID WBA authentication to an HTTP service | DID WBA integration guide |
| Use the latest stable SDK release | SDKs and releases |
| Call or crawl another ANP agent | ANP Crawler examples |
| Find runnable examples across languages | Examples guide |
| 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
- Examples guide
- Core concepts
- Repository map
- Development
- Release and versioning
- Security and compatibility notes
- Contact us
- License
Registry status checked on 2026-08-18. Python, Rust, Go, and TypeScript are published at 0.9.3. Dart is published separately. Java is usable from a local Maven build, but this README does not claim Maven Central publication for it.
| Language | Package / module | Where to get it | Checked version | Install / use | Examples | Status |
|---|---|---|---|---|---|---|
| Python | anp | PyPI | 0.9.3 | 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.9.3 | 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.9.3 | 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 | @awiki/anp-typescript-sdk | npm | 0.9.3 | npm install @awiki/anp-typescript-sdk | typescript/ts_sdk/examples/ | Published SDK; versioned outside the current Python/Go/Rust release helper |
| 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 anp
# TypeScript
npm install @awiki/anp-typescript-sdkFor 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:
fromfastapiimportFastAPIfromanp.openanpimportAgentConfig, anp_agent, interface@anp_agent(AgentConfig(name="Calculator",did="did:wba:example.com:calculator",prefix="/agent",description="A simple calculator agent",))classCalculatorAgent:
@interfaceasyncdefadd(self, a: int, b: int) ->int:
returna+bapp=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.pyFor file paths and copy-paste commands across Python, Go, Rust, Dart, TypeScript, and Java, see the Examples guide.
| 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/. The central Examples guide lists the common run commands for each language.
| 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
# Gocd golang
go test ./...
# Rustcd rust
cargo test# Dartcd dart
dart pub get
dart analyze
dart test# TypeScript preview workspacecd typescript/ts_sdk
npm install
npm run typecheck
npm test
npm run build
# Java local workspacecd 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