bindu 0.3.14

A protocol framework for agent-to-agent communication

bindu

✨ Imagine a world where AI agents collaborate effortlessly and securely—no passport 🚫, no boundaries 🌐.

That’s bindu 🌻.An open source, secured protocol for agent-to-agent communication.

🚀 Powered by Decentralised Identifiers (DIDs) 🔑, secured conversations with mutual TLS (mTLS) 🔒, and a lightweight yet powerful communication protocol built on JSON-RPC 2.0 ⚡️—bindu is paving the way for the next generation of collaborative AI systems. 🌟🤖

🌟 Features

bindu helps your AI agents talk to each other seamlessly:

🔒 Super Secure - Your agents exchange secrets safely (with built-in mTLS)

🧩 Plug-and-Play - Just decorate your agent and it's ready to communicate

⚡ Lightning Fast - Quick connections without the weight

🌐 Works Everywhere - Connect any agents, regardless of their programming language

🔄 Reliable Communication - Messages always arrive correctly and in order

📦 Installation

# Using pip
pip install bindu

# 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/

Follow the interactive prompts:

[1/4] name (pebble_project): my_weather_agent
[2/4] description (): A weather forecasting agent
[3/4] bindu_email (): [e-mail]
[4/4] Select agent_framework
  1 - none
  2 - agno
  3 - crew
  4 - langchain
  Choose from [1/2/3/4] (1): 2

After project creation:

🎉 Project created successfully!

🌻 Welcome to bindu — powered by the bindu CLI.
Next steps:
  1️⃣  cd 'my_weather_agent'
  2️⃣  Set it up using uv: 📦
      uv sync
  3️⃣  Run your agent locally: 💻
      PYTHONPATH=src python3 -m my_weather_agent
      or
      python3 src/<filename.py>
  4️⃣  Deploy your agent: 🚀
      pebble launch

🤖 Selected agent framework: agno
Need help? See README.md for details. ✨

Setup and run your agent:

# Navigate to your project
cd my_weather_agent

# Create virtual environment
uv venv --python 3.12.9
source .venv/bin/activate

# Install dependencies
uv sync

# Run your agent
uv run src/pebble_agent.py

Your agent will start with full bindu capabilities:

• ✅ Automatic DID identity generation
• ✅ Security setup with mTLS certificates
• ✅ Agent manifest creation
• ✅ Local server running on http://localhost:8030
• ✅ OpenInference observability integration

📂 Template Repository: cookiecutter-bindu

Manual Setup - bindufy an Agent

from bindu import bindufy

@bindufy(name="My Agent", description="A simple agent", version="1.0.0")
def my_agent(message: str) -> str:
    return "Hello, Agent!"

# You're now ready to communicate securely between agents!

bindufy a Agno Agent

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

@bindufy(name="Agno Agent", description="A helpful assistant", version="1.0.0")
def agno_agent(message: str) -> str:
    agent = Agent(
        model=OpenAIChat(id="gpt-4o"),
        instructions="You are a helpful assistant.",
    )
    result = agent.run(message)
    return result.to_dict()["content"]

# You're now ready to communicate securely between agents!

🎥 Agent in Action

📊 Interactive Diagrams

🔄 Sequence Diagram Open the interactive version of this sequence diagram in MermaidChart

🏗️ Orchestration Diagram Open the interactive version of this orchestration diagram in MermaidChart

🛠️ Supported Agent Frameworks

bindu is tested and integrated with popular agent frameworks:

• ✅ Agno
• 🔜 CrewAI (Coming soon)
• 🔜 AutoGen (Coming soon)
• 🔜 LangChain (Coming soon)
• 🔜 LlamaIndex (Coming soon)

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

📖 Documentation

For comprehensive documentation, visit docs.bindu.ai

🧪 Testing

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

# Run tests with coverage
make test
make coverage

🤝 Contributing

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

# Clone the repository
git clone https://github.com/bindu-ai/pebble.git
cd pebble

# Install development dependencies
uv sync --dev

# Install pre-commit hooks
pre-commit install

# Run tests
make test

Please see our Contributing Guidelines for more details.

👥 Maintainers

For more details about maintainership, including how to become a maintainer, see our MAINTAINERS.md file.

📜 License

bindu is proudly open-source and licensed under the MIT License.

💻 Example Use Cases

bindu is ideal for:

• Multi-Agent Collaboration: Enable efficient, secure teamwork between LLM-driven agents.
• Decentralized Autonomous Systems: Build reliable decentralized AI networks.
• Secure Agent Ecosystems: Create ecosystems where agents from different providers interact seamlessly.
• Distributed AI Workflows: Coordinate agents across distributed computing environments.

🎉 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!

🚧 Roadmap

Here's what's next for bindu:

• GRPC transport support
• Integration with Hibiscus (DiD - Decentralized Identifiers, mTLS)
• Detailed tutorials and guides
• Expanded multi-framework support

Suggest features or contribute by joining our Discord!

FAQ

Can bindu be deployed locally? Yes! bindu supports local development as well as cloud-based deployments.

Security:

curl --request POST
--url https://dev-tlzrol0zsxw40ujx.us.auth0.com/oauth/token
--header 'content-type: application/json'
--data '{"client_id":"GGLemeiKL6MfXD7Hy4L4mtz8WNIhRtkS","client_secret":"zXcdPIQRAM9iHzABZtcfaN_2iICW4pfuoyUChIcVDF5488ejtyKG_U_PyWj9kpJT","audience":"https://dev-tlzrol0zsxw40ujx.us.auth0.com/api/v2/","grant_type":"client_credentials"}'
| jq -r '.access_token'

Standard JSON-RPC (-32700 to -32603) ├─ -32700: Parse error ├─ -32600: Invalid Request ├─ -32601: Method not found ├─ -32602: Invalid params └─ -32603: Internal error

A2A Official (-32001 to -32007) ├─ -32001: TaskNotFoundError ✅ ├─ -32002: TaskNotCancelableError ✅ ├─ -32003: PushNotificationNotSupportedError ✅ ├─ -32004: UnsupportedOperationError ✅ ├─ -32005: ContentTypeNotSupportedError ✅ ├─ -32006: InvalidAgentResponseError ✅ └─ -32007: AuthenticatedExtendedCardNotConfiguredError ✅

Bindu Extensions (-32008 to -32099) ├─ -32008: TaskImmutableError (custom) ├─ -32009 to -32013: Authentication errors └─ -32020 to -32021: Context errors

⭐ Star History

Built with ❤️ by the bindu team from Amsterdam 🌷.

Happy bindu! 🌻🚀✨