bindu 2025.50.4

A protocol framework for agent-to-agent communication

The identity, communication & payments layer for AI agents. Dreaming of a world where agents gossip, argue & collaborate like a real society of their own.

Demo

Watch a short walkthrough of Bindu in action:

What is Bindu 🌻

Modern agents can reason, plan, and call tools, but connecting them to each other and to existing systems is still hard. We now have open protocols for this new world: A2A, AP2, and X402. They define how agents talk, trust, and trade yet wiring them together still takes time, code, and complexity.

Bindu solves this.

Bindu is an operating layer that adds auth, payments, observability, distributed execution, and low latency on top of A2A, AP2, and X402, turning your agent into a decentralized, interoperable living server that speaks the language of the open web.

Write your agent in any framework you like, then use Bindu to "Bindu‑fy" it and plug directly into the Internet of Agents.

Bring your agent and a simple config - that's it. We take care of the rest.

Installation

# Using uv (recommended)
uv add bindu

🚀 Quick Start

Time to first agent: ~2 minutes ⏱️

On your local machine, navigate to the directory in which you want to create a project directory, and run the following command:

uvx cookiecutter https://github.com/getbindu/create-bindu-agent.git

More details can be found here.

That’s it. Your local agent becomes a live, secure, discoverable service, ready to talk with other agents anywhere.

Manual Setup - Create Your First Agent

Step 1: Create a configuration file agent_config.json:

{
  "author": "[e-mail]",
  "name": "research_agent",
  "description": "A research assistant agent",
  "deployment": {"url": "http://localhost:3773", "expose": True},
  "skills": ["skills/question-answering", "skills/pdf-processing"]
}

Full Detailed Configuration can be found here.

Step 2: Create your agent script my_agent.py:

from bindu.penguin.bindufy import bindufy
from agno.agent import Agent
from agno.tools.duckduckgo import DuckDuckGoTools
from agno.models.openai import OpenAIChat

# Define your agent
agent = Agent(
    instructions="You are a research assistant that finds and summarizes information.",
    model=OpenAIChat(id="gpt-4o"),
    tools=[DuckDuckGoTools()],
)

# Configuration
config = {
    "author": "[e-mail]",
    "name": "research_agent",
    "description": "A research assistant agent",
    "deployment": {"url": "http://localhost:3773", "expose": True},
    "skills": ["skills/question-answering", "skills/pdf-processing"],
}

# Handler function
def handler(messages: list[dict[str, str]]):
    """Process messages and return agent response.

    Args:
        messages: List of message dictionaries containing conversation history

    Returns:
        Agent response result
    """
    result = agent.run(input=messages)
    return result

# Bindu-fy it
bindufy(config, handler)

That's it! Your agent is now live at http://localhost:3773 and ready to communicate with other agents.

Minimal Agent Example (Echo Agent) — sanity check

If you want to test Bindu locally without tools or external dependencies, here is the smallest possible working agent:

from bindu.penguin.bindufy import bindufy

def handler(messages):
    return [{"role": "assistant", "content": messages[-1]["content"]}]

config = {
    "author": "[e-mail]",
    "name": "echo_agent",
    "description": "A basic echo agent for quick testing.",
    "deployment": {"url": "http://localhost:3773", "expose": True},
    "skills": []
}

bindufy(config, handler)

Run:

python examples/echo_agent.py

Test the agent with any message:

curl -X POST http://localhost:3773/messages \
-H "Content-Type: application/json" \
-d '[{"role": "user", "content": "Hello Bindu!"}]'

Expected response:

"Hello Bindu!"

🎨 Chat UI (Optional)

Want a beautiful chat interface for your agent? - It's available as part of the Bindu ecosystem. - https://localhost:3773/docs

🔧 Troubleshooting

Here are some common setup issues and their fixes to help you get up and running quickly:

Issue	Cause	Solution
Python 3.12 not found	System default Python is lower than 3.12	Install Python 3.12 and set it in PATH, or use pyenv to manage versions
bindu: command not found or import errors	Virtual environment not activated	Activate venv before running: .venv/Scripts/activate (Windows) or source .venv/bin/activate (macOS/Linux)
Port 3773 already in use	Another service is running on that port	Change the url field in config to a different port, e.g. "url": "http://localhost:4000"
Pre-commit fails during commit	Code format / lint checks not applied	Run pre-commit run --all-files after initial install
Tests fail with missing dependencies	Dev packages not installed	Install with: uv sync --dev (not only pip install bindu)
Cookiecutter install error	Cookiecutter not found	Install with uv add cookiecutter or pip install cookiecutter

Additional Tips

• If the agent starts but does not respond, re-create the venv and reinstall dependencies:

  rm -rf .venv
  uv venv --python 3.12.9
  uv sync --dev

• If running on Windows PowerShell, ensure execution policy allows venv activation:

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

This section is intended to reduce setup friction and help users quickly verify their environment is working before integrating skills, tools, or frameworks.

The Vision

a peek into the night sky
}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}
{{            +             +                  +   @          {{
}}   |                *           o     +                .    }}
{{  -O-    o               .               .          +       {{
}}   |                    _,.-----.,_         o    |          }}
{{           +    *    .-'.         .'-.          -O-         {{
}}      *            .'.-'   .---.   `'.'.         |     *    }}
{{ .                /_.-'   /     \   .'-.\                   {{
}}         ' -=*<  |-._.-  |   @   |   '-._|  >*=-    .     + }}
{{ -- )--           \`-.    \     /    .-'/                   {{
}}       *     +     `.'.    '---'    .'.'    +       o       }}
{{                  .  '-._         _.-'  .                   {{
}}         |               `~~~~~~~`       - --===D       @   }}
{{   o    -O-      *   .                  *        +          {{
}}         |                      +         .            +    }}
{{ jgs          .     @      o                        *       {{
}}       o                          *          o           .  }}
{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{{

Each symbol is an agent — a spark of intelligence. And the single tiny dot is Bindu, the origin point in the Internet of Agents.

The NightSky Connection [In Progress]

NightSky is the layer that makes swarms of agents.

In this swarm, each Bindu is a dot - annotating agents with the shared language of A2A, AP2, and X402.

Agents can be hosted anywhere on laptops, clouds, or clusters — yet speak the same protocol, trust each other by design, and work together as a single, distributed mind.

A Goal Without a Plan Is Just a Wish.

🛠️ Supported Agent Frameworks

Bindu is Agent Framework agnostic.

We did test with mainly Agno, CrewAI, LangChain, and LlamaIndex, FastAgent.

Want integration with your favorite framework? Let us know on Discord!

Testing

bindu is thoroughly tested with a test coverage of over 70%:

# Run tests with coverage
pytest -n auto --cov=bindu --cov-report= && coverage report --skip-covered --fail-under=70

Contributing

We welcome contributions! Here's how to get started:

# Clone the repository
git clone https://github.com/getbindu/Bindu.git
cd Bindu

# Install development dependencies
uv venv --python 3.12.9
source .venv/bin/activate
uv sync --dev

# Install pre-commit hooks
pre-commit run --all-files

Please see our Contributing Guidelines for more details.

Maintainers

For more details about maintainers, including how to become a maintainer, see our maintainers file.

License

Bindu is proudly open-source and licensed under the Apache License 2.0.

Community

We 💛 contributions! Whether you're fixing bugs, improving documentation, or building demos — your contributions make bindu better.

• Join our Discord for discussions and support
• Star the repository if you find it useful!

Acknowledgements

We are grateful to the following projects for the development of bindu:

• FastA2A
• 12 Factor Agents
• A2A
• AP2
• X402
• The bindu logo : https://openmoji.org/library/emoji-1F33B/
• The Ascii Space Art : https://www.asciiart.eu/space/other#google_vignette

Roadmap

Here's what's next for bindu:

• GRPC transport support
• Sentry Error Tracking.
• Ag-Ui Integration.
• Retry Mechanism add.
• Increase Test Coverage to 80%.
• Redis Scheduler Implementation.
• Postgres Database Implementation for Memory Storage.
• Authentication Support AuthKit, GitHub, AWS Cognito, Google, Azure (Microsoft Entra).
• Negotiation Support.
• AP2 End to End Support.
• Dspy Addition.
• MLTS Support.
• X402 Support with other facilitators.

Suggest features or contribute by joining our Discord!

Workshops

• AI Native in Action: Agent Symphony, AI Co-Authors & A Special Book Signing!: Google Slides

Star History

---

Built with 💛 by the team from Amsterdam 🌷
Happy Bindu! 🌻🚀✨

From idea to Internet of Agents in 2 minutes.
Your agent. Your framework. Universal protocols.

⭐ Star us on GitHub • 💬 Join Discord • 📚 Read the Docs