roomkit.

Open-source Python for conversational AI

Build agents for
real conversations.

Voice, messaging and AI agents, in one framework.
Keep the conversation together as people and channels change.

Build your first agent Find an example

Python 3.12+ MIT licensed Runs in your infrastructure

One room. People, agents and channels.Illustrative flow
SMS

“Can we talk about my order?”

A conversation begins.

One room Shared context
Voice

Same person. Same conversation.

AI, in the loop
Make the connection.
  • Voice
  • SMS
  • WhatsApp
  • Email
  • WebSocket
  • AI agents

From idea to something you can run

What will you
build first?

A voice agent.

Talk to an agent through your microphone. Give it tools to act on what you ask.

Gemini Live · API key requiredOpen the example

A connected inbox.

Bring SMS, email, web chat and an assistant into the same conversation.

Mock providers · No API keysOpen the example

A team of agents.

Route a request from triage to a specialist, then on to resolution.

Scripted handoffs · No API keysOpen the example

The room keeps it together

One conversation.
Your moving parts.

01 / Agents

Specialists.
One team.

Route work, hand off context and bring a human into the loop.

Explore orchestration

02 / Channels

Your channels.
One room.

Connect voice, messaging and AI agents around a shared room.

Explore the channels

03 / Models & tools

Your models.
Your tools.

Choose cloud or local providers. Give your agents the tools to act.

Find your setup

04 / Control

Your app.
Your rules.

Set routing and guardrails. Keep the event history and deployment in your hands.

Explore the architecture

A little code. A first conversation.

Your first room.
Starts here.

Run a complete example. No API key required.

01 Install RoomKit

pip install roomkit

02 Download the example

Save it in your working folder, then run:

python first_conversation.py
Make it yours
first_conversation.pyExcerpt
async with RoomKit() as kit:
    ai = AIChannel(
        "assistant",
        provider=MockAIProvider(
            responses=["Hello from your first room."]
        ),
    )
    kit.register_channel(WebSocketChannel("chat"))
    kit.register_channel(ai)
    room = await kit.create_room()
    await kit.attach_channel(room.id, "chat")
    await kit.attach_channel(room.id, "assistant")

Scripted reply · output from the full example

chat: Hello, RoomKit!
assistant: Hello from your first room.

Built with RoomKit. Open for you.

See where it can go.

All projects

RoomKit UI

Voice, images and your tools. Try the desktop assistant built on this framework.

Get the desktop app

RoomKit Graph

Turn agent workflows into graphs.

Explore the project

RoomKit Sandbox

Give your agents an isolated place to run code.

Explore the project

Open source grows through use

Build something.
Build with us.

Try an example. Tell us what broke. Contribute a provider, a test or a guide someone else can use.

Start building Find your first contribution