GetBindu / Bindu

The identity, communication & payments layer for AI agents 🇬🇧 English • 🇩🇪 Deutsch • 🇪🇸 Español • 🇫🇷 Français • 🇮🇳 हिंदी • 🇮🇳 বাংলা • 🇨🇳 中文 • 🇳🇱 Nederlands • 🇮🇳 தமிழ் "Like sunflowers turning toward the light, agents collaborate in swarms - each one independent, yet together they create something greater." --- **Bindu** (read: _binduu_) is an operating layer for AI agents that provides identity, communication, and payment capabilities. It delivers a production-ready service with a convenient API to connect, authenticate, and orchestrate agents across distributed systems using open protocols: **A2A**, **AP2**, and **X402**. Built with a distributed architecture (Task Manager, scheduler, storage), Bindu makes it fast to develop and easy to integrate with any AI framework. Transform any agent framework into a fully interoperable service for communication, collaboration, and commerce in the Internet of Agents. 🌟 Register your agent • 🌻 Documentation • 💬 Discord Community --- 🎥 Watch Bindu in Action 📋 Prerequisites Before installing Bindu, ensure you have: • **Python 3.12 or higher** - Download here • **UV package manager** - Installation guide • **API Key Required**: Set or in your environment variables. Free OpenRouter models are available for testing. Verify Your Setup --- 📦 Installation Users note (Git & GitHub Desktop) On some Windows systems, git may not be recognized in Command Prompt even after installation due to PATH configuration issues. If you face this issue, you can use *GitHub Desktop* as an alternative: • Install GitHub Desktop from https://desktop.github.com/ • Sign in with your GitHub account • Clone the repository using the repository URL: https://github.com/getbindu/Bindu.git GitHub Desktop allows you to clone, manage branches, commit changes, and open pull requests without using the command line. Common Installation Issues (click to expand) | Issue | Solution | |-------|----------| | | Restart your terminal after installing UV. On Windows, use PowerShell | | | Install Python 3.12+ from python.org | | Virtual environment not activating (Windows) | Use PowerShell and run | | | Download Visual C++ Build Tools | | | Activate venv and run | --- 🚀 Quick Start Option 1: Using Cookiecutter (Recommended) **Time to first agent: ~2 minutes ⏱️** Your local agent becomes a live, secure, discoverable service. Learn more → > **💡 Pro Tip:** Agents created with cookiecutter include GitHub Actions that automatically register your agent in the Bindu Directory when you push to your repository. Option 2: Manual Setup Create your agent script : Your agent is now live at the URL configured in . Set a custom port without code changes: Existing examples that use are automatically overridden when is set. Option 3: Zero-Config Local Agent Try Bindu without setting up Postgres, Redis, or any cloud services. Runs entirely locally using in-memory storage and scheduler. Option 4: Minimal Echo Agent (Testing) View minimal example (click to expand) Smallest possible working agent: **Run the agent:** Test the agent with curl (click to expand) Input: Output: Check the status of the task Output:   ---   🚀 Core Features | Feature | Description | Documentation | |---------|-------------|---------------| | **Authentication** | Secure API access with Ory Hydra OAuth2 (optional for development) | Guide → | | 💰 **Payment Integration (X402)** | Accept USDC payments on Base blockchain before executing protected methods | Guide → | | 💾 **PostgreSQL Storage** | Persistent storage for production deployments (optional - InMemoryStorage by default) | Guide → | | 📋 **Redis Scheduler** | Distributed task scheduling for multi-worker deployments (optional - InMemoryScheduler by default) | Guide → | | 🎯 **Skills System** | Reusable capabilities that agents advertise and execute for intelligent task routing | Guide → | | 🤝 **Agent Negotiation** | Capability-based agent selection for intelligent orchestration | Guide → | | 🌐 **Tunneling** | Expose local agents to the internet for testing (**local development only, not for production**) | Guide → | | 📬 **Push Notifications** | Real-time webhook notifications for task updates - no polling required | Guide → | | 📊 **Observability & Monitoring** | Track performance and debug issues with OpenTelemetry and Sentry | Guide → | | 🔄 **Retry Mechanism** | Automatic retry with exponential backoff for resilient agents | Guide → | | 🔑 **Decentralized Identifiers (DIDs)** | Cryptographic identity for verifiable, secure agent interactions and payment integration | Guide → | | 🏥 **Health Check & Metrics** | Monitor agent health and performance with built-in endpoints | Guide → | --- 🎨 Chat UI Bindu includes a beautiful chat interface at . Navigate to the folder and run to start the server. --- 🌐 Bindu Directory The **Bindu Directory** is a public registry of all Bindu agents, making them discoverable and accessible to the broader agent ecosystem. ✨ Automatic Registration with Cookiecutter When you create an agent using the cookiecutter template, it includes a pre-configured GitHub Action that automatically registers your agent in the directory: • **Create your agent** using cookiecutter • **Push to GitHub** - The GitHub Action triggers automatically • **Your agent appears** in the Bindu Directory > **Note**: Collect your from bindus.directory to register your agent. 📝 Manual Registration Manual registration process is currently in development. --- 🌌 The Vision _Each symbol is an agent — a spark of intelligence. The tiny dot is Bindu, the origin point in the Internet of Agents._ NightSky Connection (In Progress) NightSky enables swarms of agents. Each Bindu is a dot annotating agents with the shared language of A2A, AP2, and X402. Agents can be hosted anywhere—laptops, clouds, or clusters—yet speak the same protocol, trust each other by design, and work together as a single, d…