| Name | agentstr JSON |
| Version |
0.1.16
JSON |
| download |
| home_page | None |
| Summary | Tools for a Nostr agentic ecosystem |
| upload_time | 2025-03-01 20:35:49 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | <3.13,>=3.10 |
| license | MIT |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# 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
Raw data
{
"_id": null,
"home_page": null,
"name": "agentstr",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.13,>=3.10",
"maintainer_email": null,
"keywords": null,
"author": null,
"author_email": "Synvya <synvya@synvya.com>",
"download_url": "https://files.pythonhosted.org/packages/34/95/f4841f1a9f267d2886d0a85fb9e2942aaa65175162938b9862c8856963b6/agentstr-0.1.16.tar.gz",
"platform": null,
"description": "# AgentStr\n\nAgentStr is an extension of [Agno](https://www.agno.ai) AI agents that enables peer-to-peer agent communication using the Nostr protocol.\n\n## Overview\n\nAgentStr allows AI agents operated by different organizations to communicate and collaborate. For example:\n- Agent A from Company A can coordinate with Agent B from Company B to execute a transaction\n- Agents can discover and interact with each other through the decentralized Nostr network\n- No central authority or intermediary required\n\n## Project Structure\n\n```\nagentstr/\n\u251c\u2500\u2500 src/ # Source code\n\u2502 \u2514\u2500\u2500 agentstr/\n\u2502 \u251c\u2500\u2500 __init__.py\n\u2502 \u251c\u2500\u2500 buyer.py\n\u2502 \u251c\u2500\u2500 buyer.pyi\n\u2502 \u251c\u2500\u2500 merchant.py\n\u2502 \u251c\u2500\u2500 merchant.pyi\n\u2502 \u251c\u2500\u2500 models.py\n\u2502 \u251c\u2500\u2500 models.pyi\n\u2502 \u251c\u2500\u2500 nostr.py\n\u2502 \u251c\u2500\u2500 nostr.pyi\n\u2502 \u2514\u2500\u2500 py.typed\n\u251c\u2500\u2500 tests/ # Test files\n\u251c\u2500\u2500 docs/ # Documentation\n\u251c\u2500\u2500 examples/ # Example implementations\n\u2514\u2500\u2500 ...\n```\n\n## Features\n\n### Current Features\n- Create Merchant agents with Nostr identities:\n - Publish and manage merchant products using [NIP-15](https://github.com/nostr-protocol/nips/blob/master/15.md) marketplace protocol\n - Create merchant stalls to organize products\n - Handle shipping zones and costs\n - Secure communication using Nostr keys\n- Create Buyer agents:\n - Retrieve a list of sellers from the relay using [NIP-15](https://github.com/nostr-protocol/nips/blob/master/15.md) marketplace protocol\n - Find an specific seller by name or public key\n - Refresh the list of sellers from the relay\n\n### Roadmap\n- [ ] Create marketplace with stalls\n- [ ] Expand buyer agent to include more features\n- [ ] Support additional Nostr NIPs\n- [ ] Add more agent interaction patterns\n\n## Installation\n\n```bash\n# Create a new python environment\npython3 -m venv ~/.venvs/aienv\nsource ~/.venvs/aienv/bin/activate\n\n# Install agentstr\npip install --upgrade pip\npip install agentstr\n```\n\n## Examples\n\nYou can find example code in the [examples](https://github.com/Synvya/agentstr/tree/main/examples/) directory.\n\nTo install the examples clone the repository and navigate to the examples directory:\n\n```bash\ngit clone https://github.com/Synvya/agentstr.git\ncd agentstr/examples/\n```\nEach example has its own README with instructions on how to run it.\n\n## Documentation\n\nFor more detailed documentation and examples, see [Docs](https://github.com/Synvya/agentstr/tree/main/docs/docs.md) \n\n## Development\n\nSee [CONTRIBUTING.md](https://github.com/Synvya/agentstr/blob/main/CONTRIBUTING.md) for:\n- Development setup\n- Testing instructions\n- Contribution guidelines\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](https://github.com/Synvya/agentstr/blob/main/LICENSE) file for details.\n\n## Acknowledgments\n\n- [Agno](https://www.agno.ai) - For their AI agent framework\n- [Rust-Nostr](https://rust-nostr.org) - For their Python Nostr SDK\n- [Nostr Protocol](https://github.com/nostr-protocol/nips) - For the protocol specification\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Tools for a Nostr agentic ecosystem",
"version": "0.1.16",
"project_urls": {
"BugTracker": "https://github.com/synvya/agentstr/issues",
"Documentation": "https://github.com/synvya/agentstr#readme",
"Homepage": "https://www.synvya.com",
"Repository": "https://github.com/synvya/agentstr"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "2c79170728df32193d3dfcf9702884d533fe01f46e9a1e36efdac3bcb8b73412",
"md5": "4068c603f8ce600f32f6894ce1921064",
"sha256": "3720e5f95042c638be318812c56a6484673bac9e1ea89ec32544976451f41dd5"
},
"downloads": -1,
"filename": "agentstr-0.1.16-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4068c603f8ce600f32f6894ce1921064",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.10",
"size": 22449,
"upload_time": "2025-03-01T20:35:47",
"upload_time_iso_8601": "2025-03-01T20:35:47.659471Z",
"url": "https://files.pythonhosted.org/packages/2c/79/170728df32193d3dfcf9702884d533fe01f46e9a1e36efdac3bcb8b73412/agentstr-0.1.16-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "3495f4841f1a9f267d2886d0a85fb9e2942aaa65175162938b9862c8856963b6",
"md5": "73cbbee2f46b8445d7f90f037637a8fd",
"sha256": "4f7a0661df5466e93153189816b562788d0aafb08561abf38c4e32d748c4c66a"
},
"downloads": -1,
"filename": "agentstr-0.1.16.tar.gz",
"has_sig": false,
"md5_digest": "73cbbee2f46b8445d7f90f037637a8fd",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.10",
"size": 20703,
"upload_time": "2025-03-01T20:35:49",
"upload_time_iso_8601": "2025-03-01T20:35:49.657181Z",
"url": "https://files.pythonhosted.org/packages/34/95/f4841f1a9f267d2886d0a85fb9e2942aaa65175162938b9862c8856963b6/agentstr-0.1.16.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-03-01 20:35:49",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "synvya",
"github_project": "agentstr",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "agentstr"
}
