agentstr 0.1.10__py3-none-any.whl → 0.1.12__py3-none-any.whl

agentstr-0.1.12.dist-info/METADATA

@@ -0,0 +1,129 @@
+Metadata-Version: 2.2
+Name: agentstr
+Version: 0.1.12
+Summary: Nostr extension for Agno AI agents
+Author-email: Synvya <info@synvya.com>
+License: MIT
+Project-URL: Homepage, https://www.synvya.com
+Project-URL: Repository, https://github.com/synvya/agentstr
+Project-URL: Documentation, https://github.com/synvya/agentstr#readme
+Project-URL: BugTracker, https://github.com/synvya/agentstr/issues
+Requires-Python: <3.13,>=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: agno>=1.1.1
+Requires-Dist: openai>=1.50.0
+Requires-Dist: packaging>=24.0
+Requires-Dist: nostr_sdk>=0.39.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: cassandra-driver>=3.29.2
+Requires-Dist: cassio>=0.1.10
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.5; extra == "dev"
+Requires-Dist: black>=23.0; extra == "dev"
+Requires-Dist: isort>=5.0; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: python-dotenv>=1.0; extra == "dev"
+
+# AgentStr
+
+AgentStr is an extension of [Agno](https://www.agno.ai) AI agents that enables peer-to-peer agent communication using the Nostr protocol.
+
+## Overview
+
+AgentStr allows AI agents operated by different organizations to communicate and collaborate. For example:
+- Agent A from Company A can coordinate with Agent B from Company B to execute a transaction
+- Agents can discover and interact with each other through the decentralized Nostr network
+- No central authority or intermediary required
+
+## Project Structure
+
+```
+agentstr/
+├── src/              # Source code
+│   └── agentstr/
+│       ├── __init__.py
+│       ├── buyer.py
+│       ├── buyer.pyi
+│       ├── merchant.py
+│       ├── merchant.pyi
+│       ├── models.py
+│       ├── models.pyi
+│       ├── nostr.py
+│       ├── nostr.pyi
+│       └── py.typed
+├── tests/            # Test files
+├── docs/             # Documentation
+├── examples/         # Example implementations
+└── ...
+```
+
+## Features
+
+### Current Features
+- Create Merchant agents with Nostr identities:
+  - Publish and manage merchant products using [NIP-15](https://github.com/nostr-protocol/nips/blob/master/15.md) marketplace protocol
+  - Create merchant stalls to organize products
+  - Handle shipping zones and costs
+  - Secure communication using Nostr keys
+- Create Buyer agents:
+  - Retrieve a list of sellers from the relay using [NIP-15](https://github.com/nostr-protocol/nips/blob/master/15.md) marketplace protocol
+  - Find an specific seller by name or public key
+  - Refresh the list of sellers from the relay
+
+### Roadmap
+- [ ] Create marketplace with stalls
+- [ ] Expand buyer agent to include more features
+- [ ] Support additional Nostr NIPs
+- [ ] Add more agent interaction patterns
+
+## Installation
+
+```bash
+# Create a new python environment
+python3 -m venv ~/.venvs/aienv
+source ~/.venvs/aienv/bin/activate
+
+# Install agentstr
+pip install --upgrade pip
+pip install agentstr
+```
+
+## Examples
+
+You can find example code in the [examples](https://github.com/Synvya/agentstr/tree/main/examples/) directory.
+
+To install the examples clone the repository and navigate to the examples directory:
+
+```bash
+git clone https://github.com/Synvya/agentstr.git
+cd agentstr/examples/
+```
+Each example has its own README with instructions on how to run it.
+
+## Documentation
+
+For more detailed documentation and examples, see [Docs](https://github.com/Synvya/agentstr/tree/main/docs/docs.md) 
+
+## Development
+
+See [CONTRIBUTING.md](https://github.com/Synvya/agentstr/blob/main/CONTRIBUTING.md) for:
+- Development setup
+- Testing instructions
+- Contribution guidelines
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](https://github.com/Synvya/agentstr/blob/main/LICENSE) file for details.
+
+## Acknowledgments
+
+- [Agno](https://www.agno.ai) - For their AI agent framework
+- [Rust-Nostr](https://rust-nostr.org) - For their Python Nostr SDK
+- [Nostr Protocol](https://github.com/nostr-protocol/nips) - For the protocol specification
+
+This software includes the following software licensed under the [Apache License 2.0](http://www.apache.org/licenses/LICENSE-2.0):
+- [DataStax Python Driver for Apache Cassandra](https://github.com/datastax/python-driver)
+- [cassIO](https://github.com/CassioML/cassio). This library is not maintained anymore. We will need to replace it with a new library.
+

agentstr-0.1.12.dist-info/RECORD

@@ -0,0 +1,15 @@
+agentstr/__init__.py,sha256=t2nKJcQ0cq3uYc5sadpJGXSO08UViAEfifCQE9pa068,800
+agentstr/buyer.py,sha256=rifdCC4FSmbLimA94AhSp3UaCA5vxtH61j_KgVJwkVo,9848
+agentstr/buyer.pyi,sha256=Zs2SbItabztcGg_cJF8_5Mf-p7Me34hxoFHEkC1inDU,1168
+agentstr/merchant.py,sha256=Uf3LkV5HlyuOZBA-covkUnDYaxI91yHvmVYOD8kk4cM,35225
+agentstr/merchant.pyi,sha256=bAYP8qz9GTGNeyFEkZsc4CqdCsC2HV4nrV0dWyYu1VY,1440
+agentstr/models.py,sha256=-anXkTmOANTKw-elxKG-RZCarCGBIWlUHiUoMBrE3FQ,11488
+agentstr/models.pyi,sha256=QVnjv01cuMynOjzuEcct72yO-LUWpdxEeiEzcf7QTl4,2867
+agentstr/nostr.py,sha256=VSC5gDN8XM54BSlfQ0yYv2N3DdTVVviWg5VJkJOD5R0,23199
+agentstr/nostr.pyi,sha256=A-Dq0ZVuZuXEXnMfgVhKRym4ubFnsSjFrgH1Db1JMCI,2647
+agentstr/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+agentstr-0.1.12.dist-info/LICENSE,sha256=20H0yoEDN5XO1xPXyZCyJjvSTP0YiarRMKWPfiaBhQY,1063
+agentstr-0.1.12.dist-info/METADATA,sha256=idnYX1pNr1qsbQXDOTdHmmPBEy3pa9RLdinZn6PeIsE,4475
+agentstr-0.1.12.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+agentstr-0.1.12.dist-info/top_level.txt,sha256=KZObFRHppZvKUGYB_m9w5HhLwps7jj7w6Xrw73dH2ss,9
+agentstr-0.1.12.dist-info/RECORD,,

agentstr/examples/basic_cli/.env.example

@@ -1,2 +0,0 @@
-OPENAI_API_KEY="your-openai-api-key"
-NSEC_BASIC_CLI_KEY="your-nsec-test-key"

agentstr/examples/basic_cli/README.md

@@ -1,11 +0,0 @@
-# Basic CLI Agent Example
-
-This example demonstrates a complete setup of a merchant agent with:
-- Multiple stalls (Hardware Store and Trade School)
-- Multiple products per stall
-- Different shipping zones and costs
-- Interactive CLI interface
-
-## Setup
-
-1. Copy `.env.example` to `.env` and fill in your keys: 

agentstr/examples/basic_cli/main.py

@@ -1,193 +0,0 @@
-from os import getenv
-from pathlib import Path
-from typing import List, Tuple
-
-import httpx
-from dotenv import load_dotenv
-from phi.agent import Agent  # type: ignore
-from phi.model.openai import OpenAIChat  # type: ignore
-
-from agentstr.marketplace import (
-    Merchant,
-    MerchantProduct,
-    MerchantStall,
-    Profile,
-    ShippingCost,
-    ShippingMethod,
-)
-
-load_dotenv()
-
-RELAY = "wss://relay.damus.io"
-
-# --*-- Merchant info
-MERCHANT_NAME = "Merchant 1"
-MERCHANT_DESCRIPTION = "Selling products peer to peer"
-MERCHANT_PICTURE = "https://i.nostr.build/ocjZ5GlAKwrvgRhx.png"
-
-# --*-- Stall info
-STALL_1_NAME = "The Hardware Store"
-STALL_1_ID = "212au4Pi"  # "212a26qV"
-STALL_1_DESCRIPTION = "Your neighborhood hardware store, now available online."
-STALL_1_CURRENCY = "Sats"
-
-STALL_2_NAME = "The Trade School"
-STALL_2_ID = "c8762EFD"
-STALL_2_DESCRIPTION = (
-    "Educational videos to put all your hardware supplies to good use."
-)
-STALL_2_CURRENCY = "Sats"
-
-# --*-- Shipping info
-SHIPPING_ZONE_1_NAME = "North America"
-SHIPPING_ZONE_1_ID = "64be11rM"
-SHIPPING_ZONE_1_REGIONS = ["Canada", "Mexico", "USA"]
-
-SHIPPING_ZONE_2_NAME = "Rest of the World"
-SHIPPING_ZONE_2_ID = "d041HK7s"
-SHIPPING_ZONE_2_REGIONS = ["All other countries"]
-
-SHIPPING_ZONE_3_NAME = "Worldwide"
-SHIPPING_ZONE_3_ID = "R8Gzz96K"
-SHIPPING_ZONE_3_REGIONS = ["Worldwide"]
-
-# --*-- Product info
-PRODUCT_1_NAME = "Wrench"
-PRODUCT_1_ID = "bcf00Rx7"
-PRODUCT_1_DESCRIPTION = "The perfect tool for a $5 wrench attack."
-PRODUCT_1_IMAGES = ["https://i.nostr.build/BddyYILz0rjv1wEY.png"]
-PRODUCT_1_CURRENCY = STALL_1_CURRENCY
-PRODUCT_1_PRICE = 5000
-PRODUCT_1_QUANTITY = 100
-
-PRODUCT_2_NAME = "Shovel"
-PRODUCT_2_ID = "bcf00Rx8"
-PRODUCT_2_DESCRIPTION = "Dig holes like never before"
-PRODUCT_2_IMAGES = ["https://i.nostr.build/psL0ZtN4FZcmeiIh.png"]
-PRODUCT_2_CURRENCY = STALL_1_CURRENCY
-PRODUCT_2_PRICE = 10000
-PRODUCT_2_QUANTITY = 10
-
-PRODUCT_3_NAME = "Shovel 101"
-PRODUCT_3_ID = "ccf00Rx1"
-PRODUCT_3_DESCRIPTION = "How to dig your own grave"
-PRODUCT_3_IMAGES = ["https://i.nostr.build/psL0ZtN4FZcmeiIh.png"]
-PRODUCT_3_CURRENCY = STALL_2_CURRENCY
-PRODUCT_3_PRICE = 1000
-PRODUCT_3_QUANTITY = 1000
-
-# --*-- Define Shipping methods for stalls (nostr SDK type)
-shipping_method_1 = (
-    ShippingMethod(id=SHIPPING_ZONE_1_ID, cost=5000)
-    .name(SHIPPING_ZONE_1_NAME)
-    .regions(SHIPPING_ZONE_1_REGIONS)
-)
-
-shipping_method_2 = (
-    ShippingMethod(id=SHIPPING_ZONE_2_ID, cost=5000)
-    .name(SHIPPING_ZONE_2_NAME)
-    .regions(SHIPPING_ZONE_2_REGIONS)
-)
-
-shipping_method_3 = (
-    ShippingMethod(id=SHIPPING_ZONE_3_ID, cost=0)
-    .name(SHIPPING_ZONE_3_NAME)
-    .regions(SHIPPING_ZONE_3_REGIONS)
-)
-
-# --*-- Define Shipping costs for products (nostr SDK type)
-shipping_cost_1 = ShippingCost(id=SHIPPING_ZONE_1_ID, cost=1000)
-shipping_cost_2 = ShippingCost(id=SHIPPING_ZONE_2_ID, cost=2000)
-shipping_cost_3 = ShippingCost(id=SHIPPING_ZONE_3_ID, cost=3000)
-
-# --*-- define stalls (using ShippingMethod)
-test_stall_1 = MerchantStall(
-    id=STALL_1_ID,
-    name=STALL_1_NAME,
-    description=STALL_1_DESCRIPTION,
-    currency=STALL_1_CURRENCY,
-    shipping=[shipping_method_1, shipping_method_2],
-)
-
-test_stall_2 = MerchantStall(
-    id=STALL_2_ID,
-    name=STALL_2_NAME,
-    description=STALL_2_DESCRIPTION,
-    currency=STALL_2_CURRENCY,
-    shipping=[shipping_method_3],  # Uses ShippingMethod
-)
-
-# --*-- define products (using ShippingZone)
-test_product_1 = MerchantProduct(
-    id=PRODUCT_1_ID,
-    stall_id=STALL_1_ID,
-    name=PRODUCT_1_NAME,
-    description=PRODUCT_1_DESCRIPTION,
-    images=PRODUCT_1_IMAGES,
-    currency=PRODUCT_1_CURRENCY,
-    price=PRODUCT_1_PRICE,
-    quantity=PRODUCT_1_QUANTITY,
-    shipping=[shipping_cost_1, shipping_cost_2],
-    categories=None,
-    specs=[],  # List of lists of strings, e.g. [["Color", "Red"], ["Size", "Large"]]
-)
-
-test_product_2 = MerchantProduct(
-    id=PRODUCT_2_ID,
-    stall_id=STALL_1_ID,
-    name=PRODUCT_2_NAME,
-    description=PRODUCT_2_DESCRIPTION,
-    images=PRODUCT_2_IMAGES,
-    currency=PRODUCT_2_CURRENCY,
-    price=PRODUCT_2_PRICE,
-    quantity=PRODUCT_2_QUANTITY,
-    shipping=[shipping_cost_1, shipping_cost_2],
-    categories=None,
-    specs=[],  # List of lists of strings
-)
-
-test_product_3 = MerchantProduct(
-    id=PRODUCT_3_ID,
-    stall_id=STALL_2_ID,
-    name=PRODUCT_3_NAME,
-    description=PRODUCT_3_DESCRIPTION,
-    images=PRODUCT_3_IMAGES,
-    currency=PRODUCT_3_CURRENCY,
-    price=PRODUCT_3_PRICE,
-    quantity=PRODUCT_3_QUANTITY,
-    shipping=[shipping_cost_3],
-    categories=None,
-    specs=[],  # List of lists of strings
-)
-
-nsec = getenv("NSEC_BASIC_CLI_KEY")
-if nsec:
-    print(f"nsec: {nsec}")
-else:
-    print(f"No NSEC found")
-
-
-test_merchant = Profile(MERCHANT_NAME, MERCHANT_DESCRIPTION, MERCHANT_PICTURE, nsec)
-
-
-agent = Agent(  # type: ignore[call-arg]
-    name="Merchant Assistant",
-    model=OpenAIChat(id="gpt-4o"),
-    tools=[
-        Merchant(
-            merchant_profile=test_merchant,
-            relay=RELAY,
-            stalls=[test_stall_1, test_stall_2],
-            products=[test_product_1, test_product_2, test_product_3],
-        )
-    ],
-    show_tool_calls=True,
-    debug_mode=True,
-    async_mode=True,
-    instructions=[
-        "The Merchant Toolkit functions return JSON arrays. Provide these JSON arrays back to the console as output."
-    ],
-)
-
-# agent.print_response("List the products of the merchant")
-agent.cli_app(stream=False)

agentstr-0.1.10.dist-info/METADATA

@@ -1,133 +0,0 @@
-Metadata-Version: 2.2
-Name: agentstr
-Version: 0.1.10
-Summary: Nostr extension for Phidata AI agents
-Author-email: Synvya <info@synvya.com>
-License: MIT License
-        
-        Copyright (c) 2025 Synvya
-        
-        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://github.com/synvya/agentstr
-Project-URL: Documentation, https://github.com/synvya/agentstr#readme
-Project-URL: BugTracker, https://github.com/synvya/agentstr/issues
-Requires-Python: <3.13,>=3.9
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: phidata>=2.7.0
-Requires-Dist: openai>=1.50.0
-Requires-Dist: packaging>=24.0
-Requires-Dist: nostr-sdk>=0.38.0
-Requires-Dist: pydantic>=2.0.0
-Provides-Extra: dev
-Requires-Dist: pytest>=7.0; extra == "dev"
-Requires-Dist: black>=23.0; extra == "dev"
-Requires-Dist: isort>=5.0; extra == "dev"
-Requires-Dist: mypy>=1.0; extra == "dev"
-Requires-Dist: python-dotenv>=1.0; extra == "dev"
-
-# AgentStr
-
-AgentStr is an extension of [Phidata](https://www.phidata.com) AI agents that enables peer-to-peer agent communication using the Nostr protocol.
-
-## Overview
-
-AgentStr allows AI agents operated by different organizations to communicate and collaborate. For example:
-- Agent A from Company A can coordinate with Agent B from Company B to execute a transaction
-- Agents can discover and interact with each other through the decentralized Nostr network
-- No central authority or intermediary required
-
-## Project Structure
-
-```
-agentstr/
-├── src/              # Source code
-│   └── agentstr/
-│       ├── __init__.py
-│       ├── marketplace.py
-│       └── nostr.py
-├── tests/            # Test files
-├── docs/             # Documentation
-├── examples/         # Example implementations
-└── ...
-```
-
-## Features
-
-### Current Features
-- Create Merchant agents with Nostr identities
-- Publish and manage merchant products using [NIP-15](https://github.com/nostr-protocol/nips/blob/master/15.md) marketplace protocol
-- Create merchant stalls to organize products
-- Handle shipping zones and costs
-- Secure communication using Nostr keys
-
-### Roadmap
-- [ ] Create marketplace with stalls
-- [ ] Create Buyer agents
-- [ ] Enable merchants to define products
-- [ ] Add customer toolkit for buyers
-- [ ] Support additional Nostr NIPs
-- [ ] Add more agent interaction patterns
-
-## Installation
-
-```bash
-# Create a new python environment
-python3 -m venv ~/.venvs/aienv
-source ~/.venvs/aienv/bin/activate
-
-# Install agentstr
-pip install --upgrade pip
-pip install agentstr
-```
-
-## Examples
-
-See our [examples directory](https://github.com/Synvya/agentstr/tree/main/examples/) for complete working implementations:
-
-- [Basic CLI Agent](https://github.com/Synvya/agentstr/tree/main/examples/basic_cli/main.py) - A complete example showing:
-  - Setting up merchant profiles
-  - Creating stalls with shipping methods
-  - Defining products with shipping costs
-  - Configuring the agent with the merchant toolkit
-  - Running an interactive CLI application
-
-
-## Documentation
-
-For more detailed documentation and examples, see [Docs](https://github.com/Synvya/agentstr/tree/main/docs/docs.md) 
-
-## Development
-
-See [CONTRIBUTING.md](CONTRIBUTING.md) for:
-- Development setup
-- Testing instructions
-- Contribution guidelines
-
-## License
-
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
-
-## Acknowledgments
-
-- [Phidata](https://www.phidata.com) - For their AI agent framework
-- [Rust-Nostr](https://rust-nostr.org) - For their Python Nostr SDK
-- [Nostr Protocol](https://github.com/nostr-protocol/nips) - For the protocol specification
-

agentstr-0.1.10.dist-info/RECORD

@@ -1,11 +0,0 @@
-agentstr/__init__.py,sha256=bPXCN4fDtqII9UtDCwhWhkR6bi1LR4w0rR0vGeKPNoI,567
-agentstr/marketplace.py,sha256=CavX0WQaCiz1sQhVs-PaHZ4YYUdcabW5V5eXrhtbT5A,40406
-agentstr/nostr.py,sha256=PId6477VuShPq7nKgansgyJhJNNy9S8ycCf_3niizg4,11242
-agentstr/examples/basic_cli/.env.example,sha256=yt6kWhUgnV2wlDlilpiOIZDdJtYL_QVhtbCGl7EG58c,76
-agentstr/examples/basic_cli/README.md,sha256=ibZ1LMOZj1BGjtDxxhTLvHwbG-H6NqfobP_zPCJoYZM,310
-agentstr/examples/basic_cli/main.py,sha256=Jgzvk0ep1zFHbDns5SQzJQvDMTQqBuRdsFSkfqEc5S8,5418
-agentstr-0.1.10.dist-info/LICENSE,sha256=20H0yoEDN5XO1xPXyZCyJjvSTP0YiarRMKWPfiaBhQY,1063
-agentstr-0.1.10.dist-info/METADATA,sha256=3XSiQurtRGtTWnXvrYqdZQpXu0ry7yF0_Rot6SdfWg0,4792
-agentstr-0.1.10.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-agentstr-0.1.10.dist-info/top_level.txt,sha256=KZObFRHppZvKUGYB_m9w5HhLwps7jj7w6Xrw73dH2ss,9
-agentstr-0.1.10.dist-info/RECORD,,