agentstr

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