a2a-adapter 0.1.0__py3-none-any.whl → 0.1.1__py3-none-any.whl

{a2a_adapter-0.1.0.dist-info → a2a_adapter-0.1.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: a2a-adapter
-Version: 0.1.0
+Version: 0.1.1
 Summary: A2A Protocol Adapter SDK for integrating various agent frameworks
 Author-email: HYBRO AI <info@hybro.ai>
 License: MIT
@@ -45,16 +45,25 @@ Dynamic: license-file
 
 # A2A Adapter
 
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+[![PyPI version](https://badge.fury.io/py/a2a-adapter.svg)](https://badge.fury.io/py/a2a-adapter)
+[![License: Apache-2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
 
-**Open Source A2A Protocol Adapter SDK for Different Agent Frameworks**
+**🚀 Open Source A2A Protocol Adapter SDK - Make Any Agent Framework A2A-Compatible in 3 Lines**
 
-A Python SDK that enables seamless integration of various agent frameworks (n8n, CrewAI, LangChain, etc.) with the [A2A (Agent-to-Agent) Protocol](https://github.com/a2a-protocol/a2a-protocol). Build interoperable AI agent systems that can communicate across different platforms and frameworks.
+A Python SDK that enables seamless integration of various agent frameworks (n8n, CrewAI, LangChain, etc.) with the [A2A (Agent-to-Agent) Protocol](https://github.com/a2aproject/A2A). Build interoperable AI agent systems that can communicate across different platforms and frameworks.
+
+**✨ Key Benefits:**
+
+- 🔌 **3-line setup** - Expose any agent as A2A-compliant
+- 🌐 **Framework agnostic** - Works with n8n, CrewAI, LangChain, and more
+- 🌊 **Streaming support** - Built-in streaming for real-time responses
+- 🎯 **Production ready** - Type-safe, well-tested, and actively maintained
 
 ## Features
 
-✨ **Framework Agnostic**: Integrate n8n workflows, CrewAI crews, LangChain chains, or custom agents
+✨ **Framework Agnostic**: Integrate n8n workflows, CrewAI crews, LangChain chains, and more
 🔌 **Simple API**: 3-line setup to expose any agent as A2A-compliant
 🌊 **Streaming Support**: Built-in streaming for LangChain and custom adapters
 🎯 **Type Safe**: Leverages official A2A SDK types
@@ -87,6 +96,14 @@ A Python SDK that enables seamless integration of various agent frameworks (n8n,
 
 See [ARCHITECTURE.md](ARCHITECTURE.md) for detailed design documentation.
 
+## Documentation
+
+- 🚀 Quick Start: [QUICKSTART.md](QUICKSTART.md)
+- 🧪 Examples: [examples/](examples/)
+- 🛠 Debug & Advanced Usage: [GETTING_STARTED_DEBUG.md](GETTING_STARTED_DEBUG.md)
+- 🧠 Architecture: [ARCHITECTURE.md](ARCHITECTURE.md)
+- 🤝 Contributing: [CONTRIBUTING.md](CONTRIBUTING.md)
+
 ## Installation
 
 ### Basic Installation
@@ -117,39 +134,17 @@ pip install a2a-adapter[all]
 pip install a2a-adapter[dev]
 ```
 
-## Quick Start
+## 🚀 Quick Start
 
-### 🚀 Easy Start with Examples
+**Get started in 5 minutes!** See [QUICKSTART.md](QUICKSTART.md) for detailed guide.
 
-For the fastest way to get started, use the included examples:
+### Install
 
 ```bash
-# Clone and setup
-git clone <repository>
-cd a2a-adapter
-python -m venv .venv
-source .venv/bin/activate  # On Windows: .venv\Scripts\activate
-pip install -e .
-
-# Start an agent
-./run_agent.sh n8n        # N8n workflow agent
-./run_agent.sh crewai     # CrewAI agent
-./run_agent.sh langchain  # LangChain agent
-
-# Stop with Ctrl+C
-```
-
-**Environment Variables:**
-
-```bash
-export N8N_WEBHOOK_URL="https://your-n8n.com/webhook/your-workflow"
+pip install a2a-adapter
 ```
 
-### 📝 Manual Setup
-
-### 1. N8n Workflow Agent
-
-Expose an n8n workflow as an A2A agent:
+### Your First Agent (3 Lines!)
 
 ```python
 import asyncio
@@ -157,124 +152,66 @@ from a2a_adapter import load_a2a_agent, serve_agent
 from a2a.types import AgentCard
 
 async def main():
-    # Load adapter
     adapter = await load_a2a_agent({
         "adapter": "n8n",
-        "webhook_url": "https://n8n.example.com/webhook/math",
-        "timeout": 30
+        "webhook_url": "https://your-n8n.com/webhook/workflow"
     })
-
-    # Define agent card
-    card = AgentCard(
-        name="Math Agent",
-        description="Performs mathematical calculations via n8n"
+    serve_agent(
+        agent_card=AgentCard(name="My Agent", description="..."),
+        adapter=adapter
     )
 
-    # Start server
-    serve_agent(agent_card=card, adapter=adapter, port=9000)
-
 asyncio.run(main())
 ```
 
-### 2. CrewAI Agent
-
-Expose a CrewAI crew as an A2A agent:
-
-```python
-import asyncio
-from crewai import Crew, Agent, Task
-from a2a_adapter import load_a2a_agent, serve_agent
-from a2a.types import AgentCard
-
-# Create your crew
-crew = Crew(
-    agents=[...],
-    tasks=[...],
-    verbose=True
-)
+**That's it!** Your agent is now A2A-compatible and ready to communicate with other A2A agents.
 
-async def main():
-    adapter = await load_a2a_agent({
-        "adapter": "crewai",
-        "crew": crew
-    })
+👉 **[Read the full Quick Start Guide →](QUICKSTART.md)**
 
-    card = AgentCard(
-        name="Research Crew",
-        description="Multi-agent research team"
-    )
+## 📖 Usage Examples
 
-    serve_agent(agent_card=card, adapter=adapter, port=8001)
+### n8n Workflow → A2A Agent
 
-asyncio.run(main())
+```python
+adapter = await load_a2a_agent({
+    "adapter": "n8n",
+    "webhook_url": "https://n8n.example.com/webhook/math"
+})
 ```
 
-### 3. LangChain Agent (with Streaming)
-
-Expose a LangChain chain with streaming support:
+### CrewAI Crew → A2A Agent
 
 ```python
-import asyncio
-from langchain_openai import ChatOpenAI
-from langchain_core.prompts import ChatPromptTemplate
-from a2a_adapter import load_a2a_agent, serve_agent
-from a2a.types import AgentCard
-
-# Create chain
-prompt = ChatPromptTemplate.from_messages([
-    ("system", "You are a helpful assistant."),
-    ("user", "{input}")
-])
-llm = ChatOpenAI(model="gpt-4o-mini", streaming=True)
-chain = prompt | llm
-
-async def main():
-    adapter = await load_a2a_agent({
-        "adapter": "langchain",
-        "runnable": chain,
-        "input_key": "input"
-    })
-
-    card = AgentCard(
-        name="Chat Agent",
-        description="Streaming chat agent powered by GPT-4"
-    )
-
-    serve_agent(agent_card=card, adapter=adapter, port=8002)
-
-asyncio.run(main())
+adapter = await load_a2a_agent({
+    "adapter": "crewai",
+    "crew": your_crew_instance
+})
 ```
 
-### 4. Custom Adapter
-
-Create a custom agent with any async function:
+### LangChain Chain → A2A Agent (with Streaming)
 
 ```python
-import asyncio
-from a2a_adapter import load_a2a_agent, serve_agent
-from a2a.types import AgentCard
-
-async def my_agent_function(inputs: dict) -> str:
-    """Your custom agent logic."""
-    message = inputs["message"]
-    return f"Echo: {message}"
-
-async def main():
-    adapter = await load_a2a_agent({
-        "adapter": "callable",
-        "callable": my_agent_function
-    })
+adapter = await load_a2a_agent({
+    "adapter": "langchain",
+    "runnable": your_chain,
+    "input_key": "input"
+})
+```
 
-    card = AgentCard(
-        name="Echo Agent",
-        description="Simple echo agent"
-    )
+### Custom Function → A2A Agent
 
-    serve_agent(agent_card=card, adapter=adapter, port=8003)
+```python
+async def my_agent(inputs: dict) -> str:
+    return f"Processed: {inputs['message']}"
 
-asyncio.run(main())
+adapter = await load_a2a_agent({
+    "adapter": "callable",
+    "callable": my_agent
+})
 ```
 
+📚 **[View all examples →](examples/)**
+
 ## Advanced Usage
 
 ### Custom Adapter Class
@@ -520,38 +457,42 @@ Check if this adapter supports streaming responses.
 
 ## Framework Support
 
-| Framework           | Adapter                 | Streaming   | Status     |
-| ------------------- | ----------------------- | ----------- | ---------- |
-| **n8n**             | `N8nAgentAdapter`       | ❌          | ✅ Stable  |
-| **CrewAI**          | `CrewAIAgentAdapter`    | ❌          | ✅ Stable  |
-| **LangChain**       | `LangChainAgentAdapter` | ✅          | ✅ Stable  |
-| **Custom Function** | `CallableAgentAdapter`  | ✅ Optional | ✅ Stable  |
-| **AutoGen**         | -                       | -           | 🔜 Planned |
-| **Semantic Kernel** | -                       | -           | 🔜 Planned |
+| Framework     | Adapter                 | Non-Streaming | Streaming  | Status     |
+| ------------- | ----------------------- | ------------- | ---------- | ---------- |
+| **n8n**       | `N8nAgentAdapter`       | ✅            | 🔜 Planned | ✅ Stable  |
+| **CrewAI**    | `CrewAIAgentAdapter`    | 🔜 Planned    | 🔜 Planned | 🔜 Planned |
+| **LangChain** | `LangChainAgentAdapter` | 🔜 Planned    | 🔜 Planned | 🔜 Planned |
+
+## 🤝 Contributing
+
+We welcome contributions from the community! Whether you're fixing bugs, adding features, or improving documentation, your help makes this project better.
 
-## Contributing
+**Ways to contribute:**
 
-We welcome contributions! To add support for a new framework:
+- 🐛 **Report bugs** - Help us improve by reporting issues
+- 💡 **Suggest features** - Share your ideas for new adapters or improvements
+- 🔧 **Add adapters** - Integrate new agent frameworks (AutoGen, Semantic Kernel, etc.)
+- 📝 **Improve docs** - Make documentation clearer and more helpful
+- 🧪 **Write tests** - Increase test coverage and reliability
 
-1. Create `a2a_adapter/integrations/{framework}.py`
-2. Implement a class extending `BaseAgentAdapter`
-3. Add to `loader.py` factory function
-4. Update `integrations/__init__.py`
-5. Add optional dependency to `pyproject.toml`
-6. Create an example in `examples/`
-7. Add tests in `tests/`
-8. Update this README
+**Quick start contributing:**
 
-See [ARCHITECTURE.md](ARCHITECTURE.md) for detailed guidance.
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Make your changes
+4. Run tests (`pytest`)
+5. Submit a pull request
+
+📖 **[Read our Contributing Guide →](CONTRIBUTING.md)** for detailed instructions, coding standards, and development setup.
 
 ## Roadmap
 
 - [x] Core adapter abstraction
 - [x] N8n adapter
-- [x] CrewAI adapter
-- [x] LangChain adapter with streaming
-- [x] Callable adapter
-- [x] Comprehensive examples
+- [ ] CrewAI adapter
+- [ ] LangChain adapter with streaming
+- [ ] Callable adapter
+- [ ] Comprehensive examples
 - [ ] Task support (async execution pattern)
 - [ ] Artifact support (file uploads/downloads)
 - [ ] AutoGen adapter
@@ -585,7 +526,7 @@ See [ARCHITECTURE.md](ARCHITECTURE.md) for detailed guidance.
 
 ## License
 
-MIT License - see [LICENSE](LICENSE) file for details.
+Apache-2.0 License - see [LICENSE](LICENSE) file for details.
 
 ## Credits
 
@@ -593,12 +534,31 @@ Built with ❤️ by [HYBRO AI](https://hybro.ai)
 
 Powered by the [A2A Protocol](https://github.com/a2a-protocol/a2a-protocol)
 
-## Support
+## 💬 Community & Support
+
+- 📚 **[Full Documentation](README.md)** - Complete API reference and guides
+- 🚀 **[Quick Start Guide](QUICKSTART.md)** - Get started in 5 minutes
+- 🏗️ **[Architecture Guide](ARCHITECTURE.md)** - Deep dive into design decisions
+- 🐛 **[Report Issues](https://github.com/hybro-ai/a2a-adapter/issues)** - Found a bug? Let us know!
+- 💬 **[Discussions](https://github.com/hybro-ai/a2a-adapter/discussions)** - Ask questions and share ideas
+- 🤝 **[Contributing Guide](CONTRIBUTING.md)** - Want to contribute? Start here!
+
+## 📄 License
+
+This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.
 
-- 📚 [Documentation](https://github.com/hybro-ai/a2a-adapter)
-- 🐛 [Issue Tracker](https://github.com/hybro-ai/a2a-adapter/issues)
-- 💬 [Discussions](https://github.com/hybro-ai/a2a-adapter/discussions)
+## 🙏 Acknowledgments
+
+- Built with ❤️ by [HYBRO AI](https://hybro.ai)
+- Powered by the [A2A Protocol](https://github.com/a2a-protocol/a2a-protocol)
+- Thanks to all [contributors](https://github.com/hybro-ai/a2a-adapter/graphs/contributors) who make this project better!
 
 ---
 
-**Star ⭐ this repo if you find it useful!**
+<div align="center">
+
+**⭐ Star this repo if you find it useful! ⭐**
+
+[⬆ Back to Top](#a2a-adapter)
+
+</div>

{a2a_adapter-0.1.0.dist-info → a2a_adapter-0.1.1.dist-info}/RECORD

@@ -7,8 +7,8 @@ a2a_adapter/integrations/callable.py,sha256=GsKZO5TyJVMOAS21cr7JNVKqjg7Z2CSc9Q9v
 a2a_adapter/integrations/crewai.py,sha256=S4mF1mJeTAfMdif-su1E7jUjWgxAeFKlgz9WXlZEKN0,4813
 a2a_adapter/integrations/langchain.py,sha256=raaaJA_FS3qBsURbCbBq2bcfsRMdKgpVbKEUN3rWA4s,5866
 a2a_adapter/integrations/n8n.py,sha256=d9RqAS7y4eJZPWBaSOHBnT-wqFvTuJtmbE4rsvu5V2o,30171
-a2a_adapter-0.1.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-a2a_adapter-0.1.0.dist-info/METADATA,sha256=GV6R5E3sp4b9b0szp53n1UT7EREDAgI9OmZL8oHPLSc,16527
-a2a_adapter-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-a2a_adapter-0.1.0.dist-info/top_level.txt,sha256=b1O1dTJ2AoPEB2x-r5IHEsS2x1fczOzTrpR2DgF3LgE,12
-a2a_adapter-0.1.0.dist-info/RECORD,,
+a2a_adapter-0.1.1.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+a2a_adapter-0.1.1.dist-info/METADATA,sha256=KMdCWiROAWlADyhSFl6lmiTuznj4i53hk5meDyl2yQQ,16675
+a2a_adapter-0.1.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+a2a_adapter-0.1.1.dist-info/top_level.txt,sha256=b1O1dTJ2AoPEB2x-r5IHEsS2x1fczOzTrpR2DgF3LgE,12
+a2a_adapter-0.1.1.dist-info/RECORD,,