anp 0.3.7

An SDK that enables agents to connect with each other, allowing them to perform identity authentication, end-to-end encrypted communication, automatic protocol negotiation based on LLMs, and efficient data exchange.

English | 中文

AgentConnect

What is AgentConnect

AgentConnect is an open-source SDK implementation of the Agent Network Protocol (ANP).

The goal of Agent Network Protocol (ANP) is to become the HTTP of the Intelligent Agent Internet Era, building an open, secure, and efficient collaborative network for billions of intelligent agents.

Core Modules

Authentication

Agent identity authentication system based on DID-WBA (Decentralized Identifier - Web-Based Authentication):

• Identity Management: Create and manage agent DID documents
• Identity Verification: Provide end-to-end identity authentication and authorization
• Secure Communication: Ensure security and trustworthiness of inter-agent communication

ANP Crawler (Agent Discovery & Interaction)

Discovery and interaction tools for the agent network:

• Agent Discovery: Automatically discover and parse agent description documents
• Interface Parsing: Parse JSON-RPC interfaces and convert them to callable tools
• Protocol Interaction: Support communication with agents that comply with ANP protocol

Usage

Option 1: Install via pip

pip install agent-connect

Option 2: Source Installation (Recommended for Developers)

# 下载源码
git clone https://github.com/agent-network-protocol/AgentConnect.git
cd AgentConnect

# 使用UV配置环境
uv sync

# 运行示例
uv run python examples/python/did_wba_examples/create_did_document.py

Example Demonstration

DID-WBA Authentication Example

Location: examples/python/did_wba_examples/

Main Examples

• Create DID Document (create_did_document.py)
  Demonstrate how to generate DID documents and key pairs for agents

• Authenticate and Verify (authenticate_and_verify.py)
  Demonstrate the complete DID-WBA authentication and verification process

Running Examples

# Create DID Document
uv run python examples/python/did_wba_examples/create_did_document.py

# Authentication Demonstration
uv run python examples/python/did_wba_examples/authenticate_and_verify.py

Detailed Documentation: DID-WBA Example

ANP Crawler Agent Interaction Example

Location: examples/python/anp_crawler_examples/

Main Examples

• Simple Example (simple_amap_example.py)
  Quick Start: Connect to AMAP service and call the map search interface

• Complete Example (amap_crawler_example.py)
  Complete Demonstration: Agent discovery, interface parsing, and tool calling

Running Examples

# Quick Experience
uv run python examples/python/anp_crawler_examples/simple_amap_example.py

# Complete Function Demonstration
uv run python examples/python/anp_crawler_examples/amap_crawler_example.py

Detailed Documentation: ANP Crawler Example

Tool Recommendations

ANP Network Explorer Tool

Use the web interface to explore the agent network using natural language: ANP Network Explorer Tool

DID Document Generator Tool

Command line tool to quickly generate DID documents:

uv run python tools/did_generater/generate_did_doc.py <did> [--agent-description-url URL]

Contact Us

• Author：GaoWei Chang
• Email：[e-mail]
• Website：https://agent-network-protocol.com/
• Discord：https://discord.gg/sFjBKTY7sB
• GitHub：https://github.com/agent-network-protocol/AgentNetworkProtocol
• WeChat：flow10240

License

This project is open-sourced under the MIT License. Detailed information please refer to LICENSE file.

---

Copyright (c) 2024 GaoWei Chang