✨ Imagine a world where AI agents collaborate effortlessly and securely—no passport 🚫, no boundaries 🌐.
That’s Pebbling 🐧.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 ⚡️—Pebbling is paving the way for the next generation of collaborative AI systems. 🌟🤖
Pebbling 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
# Using pip
pip install pebbling
# Using uv (recommended)
uv add pebblingfrom pebbling import pebblify
# Define your agent
class MyAgent:
def say_hello(self):
return "Hello, Agent!"
# Pebblify your agent
pebblify(MyAgent())
# You're now ready to communicate securely between agents!Pebblify a Agno Agent
from pebbling import pebblify
from agno.agent import Agent
from agno.models.openai import OpenAIChat
# Define your agent
agent = Agent(
model=OpenAIChat(id="gpt-4o"),
instructions="You are a helpful assistant.",
)
# Pebblify your agent
pebblify(agent)
# You're now ready to communicate securely between agents!Pebbling 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!
For comprehensive documentation, visit docs.pebbling.ai
Pebbling is thoroughly tested with a test coverage of over 83%:
# Run tests with coverage
make test
make coverageWe welcome contributions! Here's how to get started:
# Clone the repository
git clone https://github.com/Pebbling-ai/pebble.git
cd pebble
# Install development dependencies
uv sync --dev
# Install pre-commit hooks
pre-commit install
# Run tests
make testPlease see our Contributing Guidelines for more details.
For more details about maintainership, including how to become a maintainer, see our MAINTAINERS.md file.
Pebbling is proudly open-source and licensed under the MIT License.
Pebbling 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.
We 💛 contributions! Whether you're fixing bugs, improving documentation, or building demos — your contributions make Pebbling better.
- Join our Discord for discussions and support
- Star the repository if you find it useful!
Here's what's next for pebbling:
- 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!
Can Pebble be deployed locally? Yes! Pebble supports local development as well as cloud-based deployments.
Does Pebble support other languages besides Python? Absolutely! Any language that can implement JSON-RPC and mTLS is compatible.
How scalable is Pebble? Pebble's minimal dependencies and protocol simplicity ensure scalability across complex agent ecosystems.
Built with ❤️ by the Pebbling team from Amsterdam 🌷.
We’re excited to see what you’ll build with Pebble! Our dream is a world where agents across the internet communicate securely, openly, and effortlessly.
Have questions, ideas, or just want to chat? Join our Discord community— we’d love to hear from you! Together, let’s lay the foundation for the next generation of AI agent collaboration.
Happy Pebbling! 🐧🚀✨