agent0-sdk 1.4.0__py3-none-any.whl

agent0_sdk-1.4.0.dist-info/METADATA

@@ -0,0 +1,403 @@
+Metadata-Version: 2.4
+Name: agent0-sdk
+Version: 1.4.0
+Summary: Python SDK for agent portability, discovery and trust based on ERC-8004
+Author-email: Agent0 Team <team@ag0.xyz>
+License: MIT License
+        
+        Copyright (c) 2025 Marco De Rossi
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+        
+Project-URL: Homepage, https://sdk.ag0.xyz
+Project-URL: Repository, https://github.com/agent0lab/agent0-py
+Project-URL: Documentation, https://sdk.ag0.xyz
+Project-URL: Source Code, https://github.com/agent0lab/agent0-py
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: web3>=6.0.0
+Requires-Dist: eth-account>=0.8.0
+Requires-Dist: requests>=2.28.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: ipfshttpclient>=0.8.0a2
+Requires-Dist: aiohttp>=3.8.0
+Requires-Dist: asyncio-throttle>=1.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: typing-extensions>=4.0.0
+Provides-Extra: indexer
+Requires-Dist: sentence-transformers>=2.2.0; extra == "indexer"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=22.0.0; extra == "dev"
+Requires-Dist: isort>=5.10.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: flake8>=5.0.0; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest>=7.0.0; extra == "test"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "test"
+Requires-Dist: pytest-cov>=4.0.0; extra == "test"
+Requires-Dist: pytest-mock>=3.10.0; extra == "test"
+Dynamic: license-file
+
+# Agent0 SDK
+
+Python SDK for agent portability, discovery and trust based on ERC-8004.
+
+Agent0 is the SDK for agentic economies. It enables agents to register, advertise their capabilities and how to communicate with them, and give each other feedback and reputation signals. All this using blockchain infrastructure (ERC-8004) and decentralized storage, enabling permissionless discovery without relying on proprietary catalogues or intermediaries.
+
+## What Does Agent0 SDK Do?
+
+Agent0 SDK enables you to:
+
+- **Create and manage agent identities** - Register your AI agent on-chain with a unique identity, configure presentation fields (name, description, image), set wallet addresses, and manage trust models with x402 support
+- **Advertise agent capabilities** - Publish MCP and A2A endpoints, with automated extraction of MCP tools and A2A skills from endpoints
+- **OASF taxonomies** - Advertise standardized skills and domains using the Open Agentic Schema Framework (OASF) taxonomies for better discovery and interoperability
+- **Enable permissionless discovery** - Make your agent discoverable by other agents and platforms using rich search by attributes, capabilities, skills, tools, tasks, and x402 support
+- **Build reputation** - Give and receive feedback, retrieve feedback history, and search agents by reputation with cryptographic authentication
+- **Cross-chain registration** - One-line registration with IPFS nodes, Pinata, Filecoin, or HTTP URIs
+- **Public indexing** - Subgraph indexing both on-chain and IPFS data for fast search and retrieval
+
+**Bug reports & feedback:** GitHub: [Report issues](https://github.com/agent0lab/agent0-py/issues) | Telegram: [Agent0 channel](https://t.me/agent0kitchen) | Email: team@ag0.xyz
+
+## Installation
+
+### Prerequisites
+
+- Python 3.8 or higher
+- pip package manager
+- Private key for signing transactions (or run in read-only mode)
+- Access to an Ethereum RPC endpoint (e.g., Alchemy, Infura)
+- (Optional) IPFS provider account (Pinata, Filecoin, or local IPFS node)
+
+### Install from PyPI
+
+```bash
+pip install agent0-sdk
+```
+
+### Install from Source
+
+```bash
+git clone https://github.com/agent0lab/agent0-py.git
+cd agent0-py
+pip install -e .
+```
+
+## Quick Start
+
+### 1. Initialize SDK
+
+```python
+from agent0_sdk import SDK
+import os
+
+# Initialize SDK with IPFS and subgraph
+sdk = SDK(
+    chainId=11155111,  # Ethereum Sepolia testnet
+    rpcUrl=os.getenv("RPC_URL"),
+    signer=os.getenv("PRIVATE_KEY"),
+    ipfs="pinata",  # Options: "pinata", "filecoinPin", "node"
+    pinataJwt=os.getenv("PINATA_JWT")  # For Pinata
+    # Subgraph URL auto-defaults from DEFAULT_SUBGRAPH_URLS
+)
+```
+
+### 2. Create and Register Agent
+
+```python
+# Create agent
+agent = sdk.createAgent(
+    name="My AI Agent",
+    description="An intelligent assistant for various tasks. Skills: data analysis, code generation.",
+    image="https://example.com/agent-image.png"
+)
+
+# Configure endpoints (automatically extracts capabilities)
+agent.setMCP("https://mcp.example.com/")  # Extracts tools, prompts, resources
+agent.setA2A("https://a2a.example.com/agent-card.json")  # Extracts skills
+agent.setENS("myagent.eth")
+
+# Add OASF skills and domains (standardized taxonomies)
+agent.addSkill("data_engineering/data_transformation_pipeline", validate_oasf=True)
+agent.addSkill("natural_language_processing/natural_language_generation/summarization", validate_oasf=True)
+agent.addDomain("finance_and_business/investment_services", validate_oasf=True)
+agent.addDomain("technology/data_science/data_science", validate_oasf=True)
+
+agent.setTrust(reputation=True, cryptoEconomic=True)
+
+# Add metadata and set status
+agent.setMetadata({"version": "1.0.0", "category": "ai-assistant"})
+agent.setActive(True)
+
+# Register on-chain with IPFS (submitted-by-default)
+reg_tx = agent.registerIPFS()
+reg = reg_tx.wait_confirmed(timeout=180).result
+print(f"Agent registered: {reg.agentId}")  # e.g., "11155111:123"
+print(f"Agent URI: {reg.agentURI}")  # e.g., "ipfs://Qm..."
+
+# (Optional) Change the agent wallet after registration
+# - On mint/registration, `agentWallet` defaults to the current owner address.
+# - Call this only if you want a DIFFERENT wallet (or after a transfer, since the wallet resets to zero).
+# - Transaction is sent by the SDK signer (agent owner), but the signature must be produced by the NEW wallet.
+wallet_tx = agent.setWallet(
+    "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
+    chainId=11155111,
+    new_wallet_signer=os.getenv("NEW_WALLET_PRIVATE_KEY"),
+)
+if wallet_tx:
+    wallet_tx.wait_confirmed(timeout=180)
+```
+
+### 3. Load and Edit Agent
+
+```python
+# Load existing agent for editing
+agent = sdk.loadAgent("11155111:123")  # Format: "chainId:agentId"
+
+# Edit agent properties
+agent.updateInfo(description="Updated description with new capabilities")
+agent.setMCP("https://new-mcp.example.com/")
+
+# Re-register to update on-chain
+update_tx = agent.registerIPFS()
+update = update_tx.wait_confirmed(timeout=180).result
+print(f"Updated: {update.agentURI}")
+```
+
+### 4. Search Agents
+
+```python
+# Search by name, capabilities, or attributes
+results = sdk.searchAgents(
+    name="AI",  # Substring search
+    mcpTools=["code_generation"],  # Specific MCP tools
+    a2aSkills=["python"],  # Specific A2A skills
+    active=True,  # Only active agents
+    x402support=True  # Payment support
+)
+
+for agent in results['items']:
+    print(f"{agent.name}: {agent.description}")
+    print(f"  Tools: {agent.mcpTools}")
+    print(f"  Skills: {agent.a2aSkills}")
+
+# Get single agent (read-only, faster)
+agent_summary = sdk.getAgent("11155111:123")
+```
+
+### 5. Give and Retrieve Feedback
+
+```python
+# On-chain-only feedback (no off-chain upload, even if IPFS is configured)
+tx = sdk.giveFeedback(
+    agentId="11155111:123",
+    value=85,  # number|string
+    tag1="data_analyst",  # Optional: tags are strings
+    tag2="finance",
+    endpoint="https://example.com/endpoint",  # Optional: saved on-chain
+)
+feedback = tx.wait_confirmed(timeout=180).result
+
+# Rich feedback (optional off-chain file + on-chain fields)
+feedback_file = sdk.prepareFeedbackFile({
+    "capability": "tools",       # Optional: MCP capability
+    "name": "code_generation",   # Optional: MCP tool name
+    "skill": "python",           # Optional: A2A skill
+    "text": "Great agent!",      # Optional
+})
+
+tx = sdk.giveFeedback(
+    agentId="11155111:123",
+    value=85,
+    tag1="data_analyst",
+    tag2="finance",
+    endpoint="https://example.com/endpoint",
+    feedbackFile=feedback_file,  # If provided, requires IPFS configured
+)
+feedback = tx.wait_confirmed(timeout=180).result
+
+# Search feedback
+results = sdk.searchFeedback(
+    agentId="11155111:123",
+    capabilities=["tools"],
+    minValue=80,
+    maxValue=100
+)
+
+# NEW: Search feedback given by a reviewer wallet (across all agents; subgraph required)
+given = sdk.searchFeedback(
+    reviewers=["0x742d35cc6634c0532925a3b844bc9e7595f0beb7"]
+)
+
+# NEW: Search feedback across multiple agents at once
+multi = sdk.searchFeedback(
+    agents=["11155111:123", "11155111:456", "11155111:789"]
+)
+
+# Get reputation summary
+summary = sdk.getReputationSummary("11155111:123")
+print(f"Average value: {summary['averageValue']}")
+```
+
+## IPFS Configuration Options
+
+```python
+# Option 1: Filecoin Pin (free for ERC-8004 agents)
+sdk = SDK(
+    chainId=11155111,
+    rpcUrl="...",
+    signer=private_key,
+    ipfs="filecoinPin",
+    filecoinPrivateKey="your-filecoin-private-key"
+)
+
+# Option 2: IPFS Node
+sdk = SDK(
+    chainId=11155111,
+    rpcUrl="...",
+    signer=private_key,
+    ipfs="node",
+    ipfsNodeUrl="https://ipfs.infura.io:5001"
+)
+
+# Option 3: Pinata (free for ERC-8004 agents)
+sdk = SDK(
+    chainId=11155111,
+    rpcUrl="...",
+    signer=private_key,
+    ipfs="pinata",
+    pinataJwt="your-pinata-jwt-token"
+)
+
+# Option 4: HTTP registration (no IPFS)
+sdk = SDK(chainId=11155111, rpcUrl="...", signer=private_key)
+agent.register("https://example.com/agent-registration.json")
+```
+
+## OASF Taxonomies
+
+The SDK includes support for the **Open Agentic Schema Framework (OASF)** taxonomies, enabling agents to advertise standardized skills and domains. This improves discoverability and interoperability across agent platforms.
+
+### Adding Skills and Domains
+
+```python
+# Add OASF skills (with optional validation)
+agent.addSkill("advanced_reasoning_planning/strategic_planning", validate_oasf=True)
+agent.addSkill("data_engineering/data_transformation_pipeline", validate_oasf=True)
+
+# Add OASF domains (with optional validation)
+agent.addDomain("finance_and_business/investment_services", validate_oasf=True)
+agent.addDomain("technology/data_science/data_visualization", validate_oasf=True)
+
+# Remove skills/domains
+agent.removeSkill("old_skill")
+agent.removeDomain("old_domain")
+```
+
+### OASF in Registration Files
+
+OASF skills and domains appear in your agent's registration file:
+
+```json
+{
+  "endpoints": [
+    {
+      "name": "OASF",
+      "endpoint": "https://github.com/agntcy/oasf/",
+      "version": "0.8",
+      "skills": [
+        "advanced_reasoning_planning/strategic_planning",
+        "data_engineering/data_transformation_pipeline"
+      ],
+      "domains": [
+        "finance_and_business/investment_services",
+        "technology/data_science/data_science"
+      ]
+    }
+  ]
+}
+```
+
+### Taxonomy Files
+
+The SDK includes complete OASF v0.8.0 taxonomy files:
+- **Skills**: `agent0_sdk/taxonomies/all_skills.json` (136 skills)
+- **Domains**: `agent0_sdk/taxonomies/all_domains.json` (204 domains)
+
+Browse these files to find appropriate skill and domain slugs. For more information, see the [OASF specification](https://github.com/agntcy/oasf) and [Release Notes v0.31](RELEASE_NOTES_0.31.md).
+
+## Use Cases
+
+- **Building agent marketplaces** - Create platforms where developers can discover, evaluate, and integrate agents based on their capabilities and reputation
+- **Agent interoperability** - Discover agents by specific capabilities (skills, tools, tasks), evaluate them through reputation signals, and integrate them via standard protocols (MCP/A2A)
+- **Managing agent reputation** - Track agent performance, collect feedback from users and other agents, and build trust signals for your agent ecosystem
+- **Cross-chain agent operations** - Deploy and manage agents across multiple blockchain networks with consistent identity and reputation
+
+## 🚀 Coming Soon
+
+- More chains (currently Ethereum Sepolia only)
+- Support for validations
+- Enhanced x402 payments
+- Semantic/Vectorial search
+- Advanced reputation aggregation
+- Import/Export to centralized catalogues
+
+## Tests
+
+Complete working examples are available in the `tests/` directory:
+
+- `test_registration.py` - Agent registration with HTTP URI
+- `test_registrationIpfs.py` - Agent registration with IPFS
+- `test_feedback.py` - Complete feedback flow with IPFS storage
+- `test_search.py` - Agent search and discovery
+- `test_transfer.py` - Agent ownership transfer
+- `test_oasf_management.py` - OASF skills/domains management (unit tests)
+- `test_real_public_servers.py` - Endpoint crawler against real public MCP/A2A servers
+- `test_multi_chain.py` - Multi-chain read-only operations (subgraph-based)
+
+## Documentation
+
+Full documentation is available at [sdk.ag0.xyz](https://sdk.ag0.xyz), including:
+
+- [Installation Guide](https://sdk.ag0.xyz/2-usage/2-1-install/)
+- [Agent Configuration](https://sdk.ag0.xyz/2-usage/2-2-configure-agents/)
+- [Registration](https://sdk.ag0.xyz/2-usage/2-3-registration-ipfs/)
+- [Search](https://sdk.ag0.xyz/2-usage/2-5-search/)
+- [Feedback](https://sdk.ag0.xyz/2-usage/2-6-use-feedback/)
+- [Key Concepts](https://sdk.ag0.xyz/1-welcome/1-2-key-concepts/)
+- [API Reference](https://sdk.ag0.xyz/5-reference/5-1-sdk/)
+
+## License
+
+Agent0 SDK is MIT-licensed public good brought to you by Marco De Rossi in collaboration with Consensys, 🦊 MetaMask and Agent0, Inc. We are looking for co-maintainers. Please reach out if you want to help.
+
+Thanks also to Edge & Node (The Graph), Protocol Labs and Pinata for their support.

agent0_sdk-1.4.0.dist-info/RECORD

@@ -0,0 +1,21 @@
+agent0_sdk/__init__.py,sha256=9YgRWcbrfvTw21YnzWU9zT5cfkXbR6eLWEB6g_-mlg4,1102
+agent0_sdk/core/agent.py,sha256=P3AX7zm4G5qkWdTJcjOvR69cCyOovHefbRoKejj6QKY,48062
+agent0_sdk/core/contracts.py,sha256=oUqzosKMeCHRvIb4AIao103aHM8sa2zEBLYi1IoLKog,22402
+agent0_sdk/core/endpoint_crawler.py,sha256=QBkFc3tBSQqHj6PtSTZ5D3_HVB00KJZJdxE3uYpI9po,13611
+agent0_sdk/core/feedback_manager.py,sha256=gHCyBYK17Yc5HcxDcbhl_blXYqulYO-7oiEvoPQomms,42585
+agent0_sdk/core/indexer.py,sha256=gz4DDQQcRbe1RQtFSgq4OZLLFwXHFIe4v2-CcpD077A,72661
+agent0_sdk/core/ipfs_client.py,sha256=17XXMpJgLWhcNUSkmduAZt409c8oJXlj9C_eTGVk-Io,14185
+agent0_sdk/core/models.py,sha256=kiCtRm_ORdBph-Ces0HStsY92jnevY5yCpITb0PZErw,12218
+agent0_sdk/core/oasf_validator.py,sha256=ZOtYYzQd7cJj3eJegi7Ch5ydoapJEjaJSxMvwzKSp5o,2980
+agent0_sdk/core/sdk.py,sha256=w1Q6oCrQoXnCd9fgFlz1rOM0P1JbLYWAB8gs1Upz4IU,39510
+agent0_sdk/core/subgraph_client.py,sha256=seEisw__r9nqQl1CgXa5DiUb6EvZ2GG7qS4wQPLILWo,29854
+agent0_sdk/core/transaction_handle.py,sha256=tKo6ny02m3eIeDGo0Wjikf-yUtl_8KYJy5YxFkPvyHo,1958
+agent0_sdk/core/value_encoding.py,sha256=NQUUvjTRAr5Tqj8t4HUGlfhak8VDmB8E5WMlfAqJwVk,3311
+agent0_sdk/core/web3_client.py,sha256=9w5ZgHILteCHSOisae3QluwuIsX3OD-VkoAc01koQWA,13786
+agent0_sdk/taxonomies/all_domains.json,sha256=buM8_6mpY8_AMbBIPzM-gtu14Tl30QDmhuQxxrlJU4c,74625
+agent0_sdk/taxonomies/all_skills.json,sha256=WVsutw3fqoj1jfDPru3CyWTr1kc1a5-EhBOWPfXnEi8,47483
+agent0_sdk-1.4.0.dist-info/licenses/LICENSE,sha256=rhZZbZm_Ovz4Oa9LNQ-ms8a1tA36wWh90ZkC0OR7WMw,1072
+agent0_sdk-1.4.0.dist-info/METADATA,sha256=HTLgCdx26mEw_7PB5--17p3_jHacbnE8roJE9qyQ7QM,15179
+agent0_sdk-1.4.0.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
+agent0_sdk-1.4.0.dist-info/top_level.txt,sha256=p4520WUKNfhU0lVWJgkrB_jdeUfvHSY3K18k4oYLNfI,11
+agent0_sdk-1.4.0.dist-info/RECORD,,

agent0_sdk-1.4.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

agent0_sdk-1.4.0.dist-info/licenses/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Marco De Rossi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

agent0_sdk-1.4.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+agent0_sdk