Back to packageRELEASE DETAILS

0.1.16

PyPI

agentstr

Tools for a Nostr agentic ecosystem

Published1 Mar 2025

Direct dependencies17

Transitive dependenciesNot calculated

README

Version 0.1.16 documentation

AgentStr

AgentStr is an extension of Agno 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 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 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

# 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 directory.

To install the examples clone the repository and navigate to the examples directory:

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

Development

See CONTRIBUTING.md for:

Development setup
Testing instructions
Contribution guidelines

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

Agno - For their AI agent framework
Rust-Nostr - For their Python Nostr SDK
Nostr Protocol - For the protocol specification

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 17

Native requirements

17 direct targetsNot calculated transitive count

Package / target	Requirement	Relationship
agno Environment { "extras": "", "marker": null, "requires_python": "<3.13,>=3.10", "evaluation": "NOT_EVALUATED" }	`agno>=1.1.1`	runtime
openai Environment { "extras": "", "marker": null, "requires_python": "<3.13,>=3.10", "evaluation": "NOT_EVALUATED" }	`openai>=1.50.0`	runtime
nostr_sdk Environment { "extras": "", "marker": null, "requires_python": "<3.13,>=3.10", "evaluation": "NOT_EVALUATED" }	`nostr_sdk>=0.39.0`	runtime
pydantic Environment { "extras": "", "marker": null, "requires_python": "<3.13,>=3.10", "evaluation": "NOT_EVALUATED" }	`pydantic>=2.0.0`	runtime
pytest Environment { "extras": "", "marker": "extra == \"dev\"", "requires_python": "<3.13,>=3.10", "evaluation": "NOT_EVALUATED" }	`pytest>=7.0; extra == "dev"`	runtime
pytest-asyncio Environment { "extras": "", "marker": "extra == \"dev\"", "requires_python": "<3.13,>=3.10", "evaluation": "NOT_EVALUATED" }	`pytest-asyncio>=0.23.5; extra == "dev"`	runtime
black Environment { "extras": "", "marker": "extra == \"dev\"", "requires_python": "<3.13,>=3.10", "evaluation": "NOT_EVALUATED" }	`black>=23.0; extra == "dev"`	runtime
isort Environment { "extras": "", "marker": "extra == \"dev\"", "requires_python": "<3.13,>=3.10", "evaluation": "NOT_EVALUATED" }	`isort>=5.0; extra == "dev"`	runtime
mypy Environment { "extras": "", "marker": "extra == \"dev\"", "requires_python": "<3.13,>=3.10", "evaluation": "NOT_EVALUATED" }	`mypy>=1.0; extra == "dev"`	runtime
pylint Environment { "extras": "", "marker": "extra == \"dev\"", "requires_python": "<3.13,>=3.10", "evaluation": "NOT_EVALUATED" }	`pylint>=3.0; extra == "dev"`	runtime
python-dotenv Environment { "extras": "", "marker": "extra == \"examples\"", "requires_python": "<3.13,>=3.10", "evaluation": "NOT_EVALUATED" }	`python-dotenv>=1.0; extra == "examples"`	runtime
psycopg Environment { "extras": "binary", "marker": "extra == \"examples\"", "requires_python": "<3.13,>=3.10", "evaluation": "NOT_EVALUATED" }	`psycopg[binary]>=3.2.5; extra == "examples"`	runtime
sqlalchemy Environment { "extras": "", "marker": "extra == \"examples\"", "requires_python": "<3.13,>=3.10", "evaluation": "NOT_EVALUATED" }	`sqlalchemy>=2.0.0; extra == "examples"`	runtime
nest-asyncio Environment { "extras": "", "marker": "extra == \"examples\"", "requires_python": "<3.13,>=3.10", "evaluation": "NOT_EVALUATED" }	`nest-asyncio>=1.6.0; extra == "examples"`	runtime
pgvector Environment { "extras": "", "marker": "extra == \"examples\"", "requires_python": "<3.13,>=3.10", "evaluation": "NOT_EVALUATED" }	`pgvector>=0.3.6; extra == "examples"`	runtime
fastapi Environment { "extras": "", "marker": "extra == \"examples\"", "requires_python": "<3.13,>=3.10", "evaluation": "NOT_EVALUATED" }	`fastapi>=0.110.0; extra == "examples"`	runtime
uvicorn Environment { "extras": "", "marker": "extra == \"examples\"", "requires_python": "<3.13,>=3.10", "evaluation": "NOT_EVALUATED" }	`uvicorn>=0.30.0; extra == "examples"`	runtime