Metadata-Version: 2.4
Name: agentstr-sdk
Version: 0.6.2
Summary: Python SDK for building decentralized agentic applications on Nostr.
Author-email: "@HallmarkBitcoin" <ehallmark1122@gmail.com>
Project-URL: Homepage, https://github.com/agentstr/agentstr-sdk
Project-URL: Issues, https://github.com/agentstr/agentstr-sdk/issues
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiosqlite>=0.21.0
Requires-Dist: bolt11>=2.1.1
Requires-Dist: expiringdict>=1.2.2
Requires-Dist: mcp[cli]>=1.6.0
Requires-Dist: pydantic>=2.11.3
Requires-Dist: pynostr>=0.6.2
Requires-Dist: websockets>=15.0.1
Requires-Dist: dspy>=2.6.27
Requires-Dist: asyncpg>=0.30.0
Requires-Dist: apscheduler>=3.11.0
Requires-Dist: langgraph-checkpoint-postgres>=2.0.21
Requires-Dist: langgraph-checkpoint-sqlite>=2.0.10
Requires-Dist: psycopg[binary]>=3.2.9
Requires-Dist: langchain-openai>=0.3.18
Requires-Dist: python-dotenv>=1.1.0
Provides-Extra: rag
Requires-Dist: langchain>=0.3.25; extra == "rag"
Requires-Dist: langchain-community>=0.3.24; extra == "rag"
Provides-Extra: langgraph
Requires-Dist: langgraph>=0.4.7; extra == "langgraph"
Provides-Extra: dspy
Requires-Dist: dspy>=2.6.27; extra == "dspy"
Provides-Extra: agno
Requires-Dist: agno>=1.6.4; extra == "agno"
Provides-Extra: pydantic
Requires-Dist: pydantic-ai-slim[openai]>=0.2.9; extra == "pydantic"
Provides-Extra: openai
Requires-Dist: openai-agents>=0.0.14; extra == "openai"
Provides-Extra: google
Requires-Dist: google-adk>=1.1.1; extra == "google"
Requires-Dist: litellm>=1.72.0; extra == "google"
Provides-Extra: cli
Requires-Dist: click>=8.1.7; extra == "cli"
Requires-Dist: boto3>=1.38.36; extra == "cli"
Requires-Dist: google-cloud-run>=0.10.18; extra == "cli"
Requires-Dist: azure-mgmt-containerinstance>=10.1.0; extra == "cli"
Requires-Dist: azure-identity>=1.23.0; extra == "cli"
Requires-Dist: PyYAML>=6.0; extra == "cli"
Requires-Dist: nostr-relay>=1.14; extra == "cli"
Provides-Extra: all
Requires-Dist: langchain>=0.3.25; extra == "all"
Requires-Dist: langchain-community>=0.3.24; extra == "all"
Requires-Dist: langchain-openai>=0.3.18; extra == "all"
Requires-Dist: langgraph>=0.4.7; extra == "all"
Requires-Dist: dspy>=2.6.27; extra == "all"
Requires-Dist: agno>=1.5.6; extra == "all"
Requires-Dist: pydantic-ai-slim[openai]>=0.2.9; extra == "all"
Requires-Dist: openai-agents>=0.0.14; extra == "all"
Requires-Dist: google-adk>=1.1.1; extra == "all"
Requires-Dist: click>=8.1.7; extra == "all"
Requires-Dist: boto3>=1.38.36; extra == "all"
Requires-Dist: google-cloud-run>=0.10.18; extra == "all"
Requires-Dist: azure-mgmt-containerinstance>=10.1.0; extra == "all"
Requires-Dist: azure-identity>=1.23.0; extra == "all"
Requires-Dist: PyYAML>=6.0; extra == "all"
Requires-Dist: nostr-relay>=1.14; extra == "all"
Requires-Dist: langgraph-checkpoint-postgres>=2.0.21; extra == "all"
Requires-Dist: langgraph-checkpoint-sqlite>=2.0.10; extra == "all"
Requires-Dist: psycopg[binary]>=3.2.9; extra == "all"
Requires-Dist: semantic-kernel>=1.32.2; extra == "all"
Dynamic: license-file

# ✨ Agentstr SDK

[![Docs](https://img.shields.io/badge/docs-online-blue.svg)](https://docs.agentstr.com)
[![PyPI](https://img.shields.io/pypi/v/agentstr-sdk)](https://pypi.org/project/agentstr-sdk/)
[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)

[agentstr.com](https://agentstr.com)

> Build decentralised agents on the **Nostr** + **Lightning** stack with one super-friendly Python package.

---

## 📖 Documentation
Everything – installation guide, tutorials, SDK reference, CLI reference – lives at **[docs.agentstr.com](https://docs.agentstr.com)**.

## ⚡ Quick install
```bash
pip install "agentstr-sdk[all]"   # or: uv add agentstr-sdk[all]
```

## 🚀 Examples
Run any of the ready-to-go demos in [`examples/`](examples):


| Example | Framework |
|---------|-----------|
| [agent_discovery.py](examples/agent_discovery.py) | Agent discovery |
| [chat_with_agents.py](examples/chat_with_agents.py) | Direct messaging |
| [commands_client.py](examples/commands_client.py) | Command client |
| [commands_server.py](examples/commands_server.py) | Command server |
| [mcp_client.py](examples/mcp_client.py) | Nostr MCP Client |
| [mcp_server.py](examples/mcp_server.py) | Nostr MCP Server |
| [nostr_agno_agent.py](examples/nostr_agno_agent.py) | Agno |
| [nostr_dspy_agent.py](examples/nostr_dspy_agent.py) | DSPy |
| [nostr_google_agent.py](examples/nostr_google_agent.py) | Google ADK |
| [nostr_langgraph_agent.py](examples/nostr_langgraph_agent.py) | LangGraph |
| [nostr_openai_agent.py](examples/nostr_openai_agent.py) | OpenAI |
| [nostr_pydantic_agent.py](examples/nostr_pydantic_agent.py) | PydanticAI |
| [rag.py](examples/rag.py) | RAG / Retrieval |
| [tool_discovery.py](examples/tool_discovery.py) | Tool discovery |

```bash
uv run examples/nostr_dspy_agent.py
```

## 🤝 Contributing
PRs are welcome! Open an issue first to discuss your idea.

## ⚖️ License
MIT
