🌐 A2A Gateway – Interoperability for AI Agents

A2A Gateway

An open-source gateway to make AI agents interoperable using Google's A2A protocol – like Hugging Face, but for agents.

✨ What is A2A Gateway?

A2A Gateway is an open-source infrastructure that enables AI agents (Claude, GPT, local LLMs, etc.) to interoperate using the A2A protocol by Google.

How Agents Communicate

Just as Hugging Face unified access to AI models, A2A Gateway aims to become the standard for collaboration among agents – public, federated, autonomous, and open.

But it is more than just a protocol implementation.

A2A Gateway is also a shared space — an open agora — for everyone interested in agentic AI interoperability to:

💬 Discuss standards and best practices
🤝 Cooperate on toolkits, adapters, and orchestrators
🚀 Contribute agents, demos, ideas, and feedback
🌱 Grow a federated ecosystem that is transparent, ethical, and developer-first

If you're building, experimenting, or just curious — you're welcome in the conversation. Join us and shape the interoperable future of AI agents.

🚀 What You Can Do with A2A Gateway

🛰️ Export Claude, GPT, or custom agents as A2A endpoints
📄 Create and share Agent Card JSONs
📦 Use the CLI to manage tasks between agents
🌍 Publish and discover agents via a public registry
🧪 Monitor activities and tasks via a dashboard (beta)

🛠️ Quickstart

📚 Docs & Guides

A2A Gateway is built to be developer-first, lightweight, and interoperable by design.
Whether you're building your first agent, federating across services, or integrating LangChain — we've got step-by-step guides to get you there fast.

Explore the core documentation to get started:

🛰️ How to Create Your First A2A Agent
Build a working agent with FastAPI and expose it via A2A in 10 minutes.
🤝 How to Federate with Other Agents
Discover, import, and route tasks across trusted agent networks.
🔌 How to Publish a LangChain Adapter
Wrap LangChain LLMs or chains and connect them to the A2A ecosystem.

→ 📖 View full documentation index

🔧 Install the CLI

pip install .

🧪 Run a demo agent

python demo_agent.py

🚀 Publish your agent

a2a-gateway publish --file agent_card.json

📬 Send a task

a2a-gateway task --to demo-gpt --input "Translate: Hello world"

📁 Available Examples

agent_card.json – A2A-compliant agent card
demo_agent.py – FastAPI test agent
examples/ – A2A requests via curl, CLI and JSON

🧾 Sample Agent Card

{
  "id": "demo-gpt",
  "name": "Demo GPT Agent",
  "description": "A simple GPT agent that translates text into English",
  "type": "llm",
  "entrypoint": "http://localhost:5001/execute",
  "capabilities": ["translation", "chat"],
  "language": "python",
  "version": "0.1.0",
  "author": "Innoturismo"
}

🤖 Run a Test Agent

python demo_agent.py

The agent responds at http://localhost:5001/execute and simulates a translation. Perfect for testing a2a-gateway publish and a2a-gateway task.

📎 Practical Examples

The examples/ folder includes:

task_via_curl.sh: send an A2A task via curl
task_via_cli.sh: send a task using the CLI
task.json: sample payload for testing or automation

🧪 Automated Tests

The project includes basic tests under tests/:

test_cli.py: tests CLI (--help, commands)
test_mocked.py: unit tests using mocks

To run tests:

pip install pytest
pytest

🧰 Dev Setup

To contribute or work locally with tests, linting and builds:

pip install -r requirements-dev.txt

Or use:

make install
make test
make lint

To run the demo agent locally:

make agent

To build and publish the PyPI package:

make build
make publish

📣 Join the Community

We're just getting started – your contribution can make a real difference 💡

⭐ Star the project
🛠️ Submit a custom agent, guide or bugfix
🧠 Join the Discord community
✍️ Write articles or tutorials – we’ll amplify them!

🏷️ A2A Gateway Compatibility Badges

If your agent or project is compatible with the A2A Gateway protocol, you can proudly show it using one of our official badges!

🚀 A2A Ready

![A2A Ready](https://img.shields.io/badge/A2A_READY-%F0%9F%9A%80-blueviolet?style=for-the-badge&logo=protocolsio&logoColor=white)

🧠 Interoperable Agent

![Interop Agent](https://img.shields.io/badge/Interoperable_Agent-%E2%9C%94%EF%B8%8F-0f4c81?style=for-the-badge&logo=linktree&logoColor=white)

👷 Developer-First

![Developer First](https://img.shields.io/badge/Developer--First-%E2%9C%A8-2aa198?style=for-the-badge&logo=github)

🧪 A2A Experimental

![A2A Experimental](https://img.shields.io/badge/A2A_Experimental-%F0%9F%94%8E-yellow?style=for-the-badge&logo=flask&logoColor=black)

🤖 Hugging Face for Agents

![HF for Agents](https://img.shields.io/badge/HuggingFace_for_Agents-%F0%9F%A4%96-orange?style=for-the-badge)

📌 How to Use

Add any of these snippets to your project's README.md:

[![A2A Ready](https://img.shields.io/badge/A2A_READY-%F0%9F%9A%80-blueviolet?style=for-the-badge&logo=protocolsio&logoColor=white)](https://github.com/therealpan/a2a-gateway)

Replace the image or color to best match your brand, or ask us on Discord for a custom badge!

Have an A2A-compatible agent? Open a pull request to be featured in the registry 🛰️

🧠 Credits

Project initiated by Pan and the A2A enthusiast crew, with support from Harmonya. With support from the AI community and inspired by Google’s A2A protocol.
Open-source, developer-first, federated design.

Licensed under MIT.

📍 Follow us on GitHub | Discord