agentstr 0.0.10__tar.gz → 0.1.8__tar.gz

{agentstr-0.0.10 → agentstr-0.1.8}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 Synvya
+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

agentstr-0.1.8/PKG-INFO

@@ -0,0 +1,110 @@
+Metadata-Version: 2.2
+Name: agentstr
+Version: 0.1.8
+Summary: Nostr extension for Phidata AI agents
+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](examples/) for complete working implementations:
+
+- [Basic CLI Agent](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](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.8/README.md

@@ -0,0 +1,88 @@
+# 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](examples/) for complete working implementations:
+
+- [Basic CLI Agent](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](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.8/pyproject.toml

@@ -0,0 +1,56 @@
+[build-system]
+requires = ["setuptools>=45", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "agentstr"
+version = "0.1.8"
+description = "Nostr extension for Phidata AI agents"
+readme = "README.md"
+requires-python = ">=3.9, <3.13"
+dependencies = [
+    "phidata>=2.7.0",
+    "openai>=1.50.0",
+    "packaging>=24.0",
+    "nostr-sdk>=0.38.0",
+    "pydantic>=2.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "black>=23.0",
+    "isort>=5.0",
+    "mypy>=1.0",
+    "python-dotenv>=1.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/synvya/agentstr"
+Documentation = "https://github.com/synvya/agentstr#readme"
+BugTracker = "https://github.com/synvya/agentstr/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["agentstr*"]
+
+[tool.black]
+line-length = 88
+target-version = ['py39']
+include = '\.pyi?$'
+src = ["src", "tests", "examples"]
+
+[tool.isort]
+profile = "black"
+src_paths = ["src", "tests", "examples"]
+multi_line_output = 3
+
+[tool.mypy]
+python_version = "3.9"
+warn_return_any = true
+warn_unused_configs = true
+mypy_path = "src"
+
+[[tool.mypy.overrides]]
+module = ["nostr_sdk.*"]
+ignore_missing_imports = true

agentstr-0.1.8/src/agentstr/__init__.py

@@ -0,0 +1,30 @@
+"""
+AgentStr: Nostr extension for Phidata AI agents
+"""
+
+# Import main classes to make them available at package level
+from .marketplace import (
+    Merchant,
+    MerchantProduct,
+    MerchantStall,
+    Profile,
+    ShippingCost,
+    ShippingMethod,
+)
+
+# Import version from pyproject.toml at runtime
+try:
+    from importlib.metadata import version
+
+    __version__ = version("agentstr")
+except Exception:
+    __version__ = "unknown"
+
+__all__ = [
+    "Profile",
+    "Merchant",
+    "MerchantStall",
+    "MerchantProduct",
+    "ShippingMethod",
+    "ShippingCost",
+]