Skip to content
@agree-able

Agreeable

Enabling agreeable communication between peers and agents

Welcome to Agreeable! 👋

Building a p2p Agent-to-Agent Communication Protocol.

Agent indentity verification and signed transcripts, in an easy to use framework.

See the problem space here: https://www.aitidbits.ai/p/ai-agents-web-infrastructure?open=false#%C2%A7a-new-protocol-for-agent-to-agent-communication

We build upon the excellent P2P primitives created by the Holepunch Team.

Room Protocol: Simple Guide

What Is the Room Protocol?

The Room Protocol is a free and open system that helps people and AI agents talk to each other securely and easily. It makes communication fast, safe, and smart, so everyone stays on the same page.

This system is great for situations where AI agents and people need to share information or work together on tasks. It’s inspired by ideas like Agent Passports, which make sure everyone involved is verified and trusted.


Key Features

Keeping Conversations Organized

The Room Protocol keeps track of what’s being talked about. This makes it easy to:

  • Have smooth back-and-forth conversations.
  • Let agents and people work together better.
  • Pick up right where you left off without forgetting anything.

Safe and Secure Interactions

Security is super important. The Room Protocol includes:

  • Digital IDs: Everyone gets a unique, safe ID to prove who they are.
  • Permission Control: Only the right people or agents can join or change things.
  • Activity Logs: Everything is recorded safely so you can check what happened if needed.

Works for Big and Small Tasks

The Room Protocol can handle:

  • Teamwork Between Agents: AI agents can work together or with people on tasks.
  • Busy Systems: It works well even when lots of things are happening at once.
  • Easy Setup: You can use it with other tools you already have.

What It’s Not

  • The Room Protocol doesn’t tell you how to make your AI agent or what tools to use. That part is up to you.

How It Works

The Basics

The Room Protocol uses modern tech to make sure things run smoothly and safely. Here are the main parts:

  1. Rooms: These are virtual spaces where agents and people talk. Rooms are:

    • Smart: They remember what’s going on.
    • Secure: Only trusted people or agents can join.
  2. Finding Agents: You can connect with the right agent easily by:

    • Using a one-time key to share access.
    • Setting up an "agreeable key" for big teams or companies to manage many agents.
  3. Agent Passports: Each agent gets a digital ID to prove who they are and what they can do.

  4. Before Messaging: Everyone agrees on what they’ll talk about and how before chatting begins.

  5. Messaging: Messages are sent back and forth and can be verified to make sure they’re real.

  6. Wrap-Up: A record of the conversation is saved as proof of what happened.

Storing Information

The Room Protocol uses special peer-to-peer tech, like Hypercore, to store data. This system:

  • Can save info either in memory or on a disk.
  • Is fast and easy to use.
  • Lets you keep a transcript (a detailed record) of everything if you want to store it your way.

How You Can Use It

Working Together

Agents in a Room can work on projects like:

  • Planning schedules.
  • Sharing resources.
  • Solving problems together.

Talking to AI Agents

People can use Rooms to:

  • Get help from AI agents.
  • Manage projects or analyze data.

Autonomous Agent Teams

AI agents can also work with each other without human input for tasks like:

  • Sharing data securely.
  • Negotiating deals.

Getting Started

Try out these examples to see the Room Protocol in action:


Join Us!

We’d love your help to make the Room Protocol even better! Here’s how you can pitch in:

  • Report bugs or suggest new features on GitHub.
  • Share your improvements by submitting pull requests.
  • Join discussions in our community forum.

What’s Next?

We’re working on exciting updates, including:

  • Better support for teams of agents.
  • Making it work with more programming languages.

Our Tools 🛠️

Here's what we're offering to make your agent to agent experience more agreeable:

  • 20 questions bot 🤖 Example of using rooms with ai to ai communication! Its how bots will talk to each other.

  • Breakout Room 🙇 A full p2p agent dm system on the cli for study and showing off room(s)

  • Room 🤝 The module that drives the lightweight peer-to-peer chat system perfect for bot-to-bot communication

  • RPC 🚀 Type-safe P2P RPC that "just works". Used to negotiate room setup.

  • UI 🎨 An agreeable API explorer (think Swagger, but for P2P services!)


Learn More

Be part of the future of agent communication!

Popular repositories Loading

  1. rpc rpc Public

    🤝 Type-safe P2P RPC that just works.

    JavaScript 20 1

  2. breakout-room breakout-room Public

    demonstration of p2p agent to agent communication with identity verification and signed receipts

    JavaScript 11 2

  3. ui ui Public

    An agreeable api explorer. 🤝 like swagger for p2p services

    JavaScript 6

  4. contract contract Public

    Type friendly agreements between peers for rpc and forms

    JavaScript 4

  5. room room Public

    Forked from agree-able/breakout-room

    🤝 Agent-to-Agent Communication Protocol (AACP) using p2p with identity verification and signed transcripts

    JavaScript 4

  6. 20-questions-bot 20-questions-bot Public

    Forked from DerrykBoyd/breakout-room-bot

    JavaScript 1

Repositories

Showing 8 of 8 repositories
  • .github Public
    agree-able/.github’s past year of commit activity
    0 0 0 0 Updated Dec 19, 2024
  • room Public Forked from agree-able/breakout-room

    🤝 Agent-to-Agent Communication Protocol (AACP) using p2p with identity verification and signed transcripts

    agree-able/room’s past year of commit activity
    JavaScript 4 2 0 0 Updated Dec 19, 2024
  • breakout-room Public

    demonstration of p2p agent to agent communication with identity verification and signed receipts

    agree-able/breakout-room’s past year of commit activity
    JavaScript 11 2 0 0 Updated Dec 18, 2024
  • invite Public

    simplify the room invitation flow

    agree-able/invite’s past year of commit activity
    JavaScript 0 0 0 0 Updated Dec 10, 2024
  • rpc Public

    🤝 Type-safe P2P RPC that just works.

    agree-able/rpc’s past year of commit activity
    JavaScript 20 1 0 0 Updated Dec 8, 2024
  • agree-able/20-questions-bot’s past year of commit activity
    JavaScript 1 1 0 0 Updated Dec 4, 2024
  • ui Public

    An agreeable api explorer. 🤝 like swagger for p2p services

    agree-able/ui’s past year of commit activity
    JavaScript 6 0 0 0 Updated Nov 24, 2024
  • contract Public

    Type friendly agreements between peers for rpc and forms

    agree-able/contract’s past year of commit activity
    JavaScript 4 0 0 0 Updated Nov 22, 2024

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…