anp
Our vision is to provide communication capabilities for intelligent agents, allowing them to connect with each other to form a collaborative network of intelligent agents.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/agent-network-protocol/anp with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/agent-network-protocol/anp'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/agent-network-protocol--anp)HTML
<a href="/listings/agent-network-protocol--anp"><img src="/api/listings/agent-network-protocol--anp/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
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 api
Create `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 8000
OpenANP 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.py
Full 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
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 326 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- <div align="center">
- [English](README.md) | [中文](README.cn.md)
- </div>
- # AgentConnect: Multi-language SDK for ANP
- AgentConnect is the multi-language SDK and reference implementation for the [Agent Network Protocol (ANP)](https://github.com/agent-network-protocol/AgentNetworkProtocol). 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.
- <p align="center">
- <img src="/images/agentic-web.png" width="50%" alt="Agentic Web"/>
- </p>
- Authentication hardening and compatibility boundaries: [Security contract](docs/authentication-security.md).
- ## What is ANP?
- 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.
- ## What this repository provides
- - **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.
- ### Handle continuity capability status
- 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.
- ## Choose your path
- | I want to... | Start here |
- |---|---|
- | Build a working ANP agent quickly | [Python OpenANP quick start](#quick-start-build-a-python-agent) |
- | Create an e1 DID and run complete authentication | [Python e1 authentication example](examples/python/did_wba_examples/e1_authenticate_and_verify.py) |
- | Add DID WBA authentication to an HTTP service | [DID WBA integration guide](examples/python/did_wba_examples/DID_WBA_AUTH_GUIDE.en.md) |
- | Resolve/authenticate DID Web and manage its public device document | [DID Web SDK guide](docs/did-web-sdk.md) |
- | Use the latest stable SDK release | [SDKs and releases](#sdks-and-releases) |
- | Call or crawl another ANP agent | [ANP Crawler examples](examples/python/anp_crawler_examples/) |
- | Find runnable examples across languages | [Examples guide](docs/examples.md) |
- | Work with proofs, WNS, or E2EE | [Core concepts](#core-concepts) and [examples](#examples-by-learning-path) |
- | Contribute to the repository | [Development](#development) |
- ## Table of contents
- - [SDKs and releases](#sdks-and-releases)
- - [Quick start: build a Python agent](#quick-start-build-a-python-agent)
- - [Examples by learning path](#examples-by-learning-path)
- - [Examples guide](docs/examples.md)
- - [Core concepts](#core-concepts)
- - [Repository map](#repository-map)
- - [Development](#development)
- - [Release and versioning](#release-and-versioning)
- - [Security and compatibility notes](#security-and-compatibility-notes)
- - [Contact us](#contact-us)
- - [License](#license)
- ## SDKs and releases
- Registry status checked on **2026-09-24**. Python, Rust, and Go are published at `1.0.5`; TypeScript is published separately at `0.9.5`. 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](https://pypi.org/project/anp/) | `1.0.5` | `pip install anp` or `pip install "anp[api]"` for OpenANP/FastAPI extras | [examples/python/](examples/python/) | Stable published SDK |
- | Go | `github.com/agent-network-protocol/anp/golang` | Go module proxy / [pkg.go.dev](https://pkg.go.dev/github.com/agent-network-protocol/anp/golang) | `v1.0.5` | `go get github.com/agent-network-protocol/anp/golang@latest` | [golang/examples/](golang/examples/) | Stable published SDK; tag format is `golang/vX.Y.Z` |
- | Rust | `anp` | [crates.io](https://crates.io/crates/anp) / [docs.rs](https://docs.rs/anp) | `1.0.5` | `cargo add anp` | [rust/examples/](rust/examples/) | Stable published SDK |
- | Dart | `anp` | [pub.dev](https://pub.dev/packages/anp) | `0.8.7` | `dart pub add anp` | [dart/example/](dart/example/) | Published SDK; versioned outside the current Python/Go/Rust release helper |
- | TypeScript | `@awiki/anp-typescript-sdk` | [npm](https://www.npmjs.com/package/@awiki/anp-typescript-sdk) | `0.9.5` | `npm install @awiki/anp-typescript-sdk` | [typescript/ts_sdk/examples/](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/](java/anp-examples/) | Local SDK; Maven Central metadata check returned not found |
- ### Minimal install snippets
- ```bash
- # 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-sdk
- ```
- For local repository development, prefer the commands in [Development](#development) instead of installing published packages.
- ## Quick start: build a Python agent
- 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:
- ```bash
- pip install "anp[api]"
- ```
- When developing from this repository, use:
- ```bash
- uv sync --extra api
- ```
- Create `app.py`:
- ```python
- 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:
- ```bash
- uvicorn app:app --port 8000
- ```
- OpenANP 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:
- ```bash
- uv run python examples/python/openanp_examples/minimal_client.py
- ```
- Full runnable pair:
- ```bash
- # Terminal 1
- uvicorn examples.python.openanp_examples.minimal_server:app --port 8000
- # Terminal 2
- uv run python examples/python/openanp_examples/minimal_client.py
- ```
- ## Examples by learning path
- For file paths and copy-paste commands across Python, Go, Rust, Dart, TypeScript, and Java, see the [Examples guide](docs/examples.md).
- | Level | Goal | Start here | Notes |
- |---|---|---|---|
- | Beginner | Build and call an ANP agent | [examples/python/openanp_examples/](examples/python/openanp_examples/) | Requires the `api` optional dependencies. |
- | Beginner | Create and verify DID WBA identity | [examples/python/did_wba_examples/](examples/python/did_wba_examples/) | Offline examples are a good first auth smoke test. |
- | Beginner | Generate and verify proofs | [examples/python/proof_examples/](examples/python/proof_examples/) | Covers W3C/Data Integrity and ANP proof helpers. |
- | Beginner | Validate and resolve WNS handles | [examples/python/wns_examples/](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/](examples/python/anp_crawler_examples/) | Crawler-style interface discovery and JSON-RPC execution. |
- | Intermediate | Run AP2 payment protocol flow | [examples/python/ap2_examples/](examples/python/ap2_examples/) | Merchant/shopper mandate examples. |
- | Intermediate | Check Python ↔ Rust interoperability | [examples/python/rust_interop_examples/](examples/python/rust_interop_examples/) | Useful when touching auth or wire fixtures. |
- | Advanced | Explore Direct E2EE examples | [examples/python/e2e_encryption_hpke_examples/](examples/python/e2e_encryption_hpke_examples/) and [docs/e2e/direct-e2ee-p5-sdk.md](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](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/](examples/python/negotiation_mode/) | Requires `.env` LLM provider configuration. |
- Language-specific examples are also available in [golang/examples/](golang/examples/), [rust/examples/](rust/examples/), [dart/example/](dart/example/), [typescript/ts_sdk/examples/](typescript/ts_sdk/examples/), and [java/anp-examples/](java/anp-examples/). The central [Examples guide](docs/examples.md) lists the common run commands for each language.
- ## Core concepts
- | 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/](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/](examples/python/openanp_examples/) |
- | OpenRPC / JSON-RPC | Interface schema and method-call transport generated from Python type hints by OpenANP. | [anp/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/](examples/python/proof_examples/) |
- | WNS | WBA Name Space helpers for human-readable handles, `wba://` URIs, resolution, and DID binding verification. | [examples/python/wns_examples/](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](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](docs/e2e/group-e2ee-p6-anp-mls.md) |
- | AP2 | Agent Payment Protocol v2 mandate models and validation helpers. | [examples/python/ap2_examples/](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/fastanp_examples/), [examples/python/e2e_encryption_v2_examples/](examples/python/e2e_encryption_v2_examples/), [examples/python/negotiation_mode/](examples/python/negotiation_mode/) |
- ## Repository map
- | Path | Purpose |
- |---|---|
- | [anp/](anp/) | Python package: OpenANP, authentication, proof, WNS, AP2, crawler, E2EE, and meta-protocol modules. |
- | [examples/python/](examples/python/) | Python examples grouped by feature and learning path. |
- | [golang/](golang/) | Pure Go ANP SDK module and examples. |
- | [rust/](rust/) | Rust `anp` crate, examples, tests, and MLS/E2EE operation surfaces. |
- | [dart/](dart/) | Dart SDK package, examples, tests, and Flutter smoke workspace. |
- | [typescript/ts_sdk/](typescript/ts_sdk/) | TypeScript SDK preview workspace for Node 20+. |
- | [java/](java/) | Java SDK modules: core `anp4j`, Spring Boot starter, and examples. |
- | [docs/](docs/) | Protocol-adjacent docs for DID, AP2, E2EE, public fixtures, and PR notes. |
- | [testdata/](testdata/) | Shared cross-language fixtures and vectors. |
- | [skills/anp-multilang-release/](skills/anp-multilang-release/) | Coordinated Python / Go / Rust release helper and policy. |
- ## Development
- Use the toolchain for the language you are changing. Common local commands:
- ```bash
- # 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 test
- ```
- Some examples require network access or `.env` configuration, especially LLM-assisted negotiation examples under [examples/python/negotiation_mode/](examples/python/negotiation_mode/).
- ## Release and versioning
- Python, Go, and Rust use one coordinated `X.Y.Z` version managed by [skills/anp-multilang-release/](skills/anp-multilang-release/). The release policy is documented in [skills/anp-multilang-release/references/release-policy.md](skills/anp-multilang-release/references/release-policy.md).
- Current coordinated release files include:
- - Python package version in [pyproject.toml](pyproject.toml) and runtime version in [anp/__init__.py](anp/__init__.py).
- - Rust crate version in [rust/Cargo.toml](rust/Cargo.toml).
- - Go runtime version in [golang/version.go](golang/version.go).
- Tag rules:
- - Root release tag: `X.Y.Z`, for example `0.8.8`.
- - Go submodule tag: `golang/vX.Y.Z`, for example `golang/v0.8.8`.
- Release planning starts with:
- ```bash
- uv run python skills/anp-multilang-release/scripts/release.py plan --version 0.8.8
- ```
- The release command validates the working tree, aligned version files, Python build, and Rust dry-run publish before publishing and pushing tags. It does not run test suites by default. When the user explicitly requests Go tests, add `--run-tests` to the plan and release commands; Python and Rust test suites remain separate opt-in commands.
- ## Security and compatibility notes
- - Load secrets from `.env` or 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.
- ## Contact us
- - **Author**: GaoWei Chang
- - **Email**: chgaowei@gmail.com
- - **Additional contact emails**: zynetzy1@aliyun.com, 2764433097@qq.com
- - **Website**: [https://agent-network-protocol.com/](https://agent-network-protocol.com/)
- - **Discord**: [https://discord.gg/sFjBKTY7sB](https://discord.gg/sFjBKTY7sB)
- - **GitHub**: [https://github.com/agent-network-protocol/AgentNetworkProtocol](https://github.com/agent-network-protocol/AgentNetworkProtocol)
- - **WeChat**: flow10240
- ## License
- This project is licensed under the [Apache License 2.0](LICENSE).
- Copyright (c) 2024 GaoWei Chang and ANP Open Source Community.
- Python, Go, Rust, Dart, TypeScript, and Java first-party SDK sources and package metadata follow this root license. Third-party dependencies keep their own licenses. Previously published package versions remain under the license declared in those artifacts; see [NOTICE](NOTICE).
- ---
- **Copyright (c) 2024 GaoWei Chang**
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.