pebble

pebble

A secure and open protocol for decentralized agent-to-agent communication. Built for speed, scale, extensibility and the AI-native internet. πŸ§πŸš€βœ¨

Stars: 94

Visit
 screenshot

Pebbling is an open-source protocol for agent-to-agent communication, enabling AI agents to collaborate securely using Decentralised Identifiers (DIDs) and mutual TLS (mTLS). It provides a lightweight communication protocol built on JSON-RPC 2.0, ensuring reliable and secure conversations between agents. Pebbling allows agents to exchange messages safely, connect seamlessly regardless of programming language, and communicate quickly and efficiently. It is designed to pave the way for the next generation of collaborative AI systems, promoting secure and effortless communication between agents across different environments.

README:

pebbling 🐧

Pebbling Banner

Agent-to-Agent Communication

GitHub License Hits Python Version Tests Coverage Status PyPI version PyPI Downloads PRs Welcome Join Discord Documentation GitHub stars

✨ 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. πŸŒŸπŸ€–

🌟 Features

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

πŸ“¦ Installation

# Using pip
pip install pebbling

# Using uv (recommended)
uv add pebbling

πŸš€ Quick Start

Pebblify an Agent

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

πŸ› οΈ Supported Agent Frameworks

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!

πŸ“– Documentation

For comprehensive documentation, visit docs.pebbling.ai

πŸ§ͺ Testing

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

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

πŸ’» Example Use Cases

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.

πŸŽ‰ Community

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!

🚧 Roadmap

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!

πŸ“‹ FAQ

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.

⭐ Star History

Star History Chart

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! πŸ§πŸš€βœ¨

For Tasks:

Click tags to check more tools for each tasks

For Jobs:

Alternative AI tools for pebble

Similar Open Source Tools

For similar tasks

For similar jobs