bindu 0.3.16

A protocol framework for agent-to-agent communication

Bindu 🌻

“We imagine a world of agents where they can communicate with each other seamlessly.
And Bindu turns your agent into a living server , the dot (Bindu) in the Internet of Agents.”

The Idea

Integration was the problem. And even today, it still is.

We built monoliths, then APIs, then microservices, then cloud functions.
Each step made systems faster, smaller, and more distributed.

Then, on 30th November 2022, something changed.
We entered the age of Large Language Models.
Software began reasoning, planning, and calling tools.
Suddenly, our code didn’t just execute, it started thinking.

But the old problem stayed the same.

Connection.

Now we have the language protocols for this new world:
A2A, AP2, and X402, how the agents talk, trust, and trade.

Yet, connecting them still takes time, code, and complexity.

That’s why Bindu exists.

Bindu is a wrapper that turns your agent into a A2A, AP2, and X402 schema-compliant living server, And communicate with other agents and microservices across the open web.

Just write your agent in any framework you like, then use Bindu. it will Bindu-fy your agent so that it can instantly join the Internet of Agents.

Installation

# Using uv (recommended)
uv add bindu

🚀 Quick Start

Quick Start with Cookiecutter Template

The fastest way to get started with bindu is using our cookiecutter template:

# Create a new bindu project
uv tool run cookiecutter cookiecutter-bindu/

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": "my_first_agent",
  "description": "A simple agent that answers questions",
  "version": "1.0.0",
  "deployment": {
    "url": "http://localhost:8030",
    "expose": true
  }
}

Full Detailed Configuration can be found here.

Step 2: Create your agent script my_agent.py:

from bindu import bindufy

from agno.agent import Agent
from agno.models.openai import OpenAIChat

from bindu.penguin.bindufy import bindufy


# Load configuration
def load_config(config_path: str):
    """Load configuration from JSON with defaults."""
    full_path = os.path.join(config_path)
    with open(full_path, "r") as f:
        return json.load(f)


simple_config = load_config("simple_agent_config.json")
simple_agent = Agent(
    instructions="Provide helpful responses to user messages",
    model=OpenAIChat(id="gpt-4o"),
)

def simple_handler(messages: list[dict[str, str]]) -> Any:
    result = simple_agent.run(input=messages)
    return result

bindufy(simple_agent, simple_config, simple_handler)

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

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 Saptha.me Connection [In Progress]

Saptha.me 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. So Saptha.me takes care Research, Plan and Implement.

Saptha.me gives them the seven layers of connection — mind, memory, trust, task, identity, value, and flow — that’s why it’s called Saptha.me. (Saptha, meaning “seven”; me, the self-aware network.)

🛠️ 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/Saptha-me/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! 🌻🚀✨