Registry / llm-agents / gabriel-protocol

gabriel-protocol

library4.1pypypiunverified

Gabriel Protocol is the official Python package for the Gabriel real-time AI orchestration framework, providing client and server tools for building composable cognitive assistant pipelines using WebSocket communication and Protocol Buffers. Current version is 4.1, supporting Python >=3.10. Releases are tagged on GitHub at cmusatyalab/gabriel.

llm-agents ai-ml web-framework serialization

pip install gabriel-protocol

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · GABRIEL-PROTOCOL

gabriel-protocol

llm-agentspythonv4.1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

ClientRunner

✓ from gabriel_protocol import ClientRunner

✗ from gabriel_protocol import ClientRunner

Basic client runner connecting to a Gabriel server.

import asyncio from gabriel_protocol import ClientRunner from gabriel_protocol.server import ServerWrapper def main(): # Example client runner token = os.environ.get('GABRIEL_TOKEN', '') async def client_task(websocket): await websocket.send('Hello') response = await websocket.recv() print('Received:', response) runner = ClientRunner('ws://localhost:9099', token=token) asyncio.run(runner.run(client_task)) if __name__ == '__main__': main()

Debug

Known issues

breakingVersion 3.0 renamed the package from 'gabriel' to 'gabriel_protocol'. Old imports break.

fix

Change 'import gabriel' to 'import gabriel_protocol' and update all submodule imports accordingly.

affects: >=3.0

deprecatedThe legacy v2 protocol (pre-3.0) is deprecated and may be removed in future versions.

fix

Upgrade to use the new WebSocket/Protobuf-based protocol. Refer to migration guide.

affects: >=3.0

gotchaThe package requires the server to be running before creating a client; otherwise, connection errors occur.

fix

Start the Gabriel server before launching any client scripts.

affects: All

Upgrade

Version history

4.1latest on PyPI · released Dec 1, 2025

Audit

Dependencies

protobufrequiredProtocol Buffers for message serialization

websocketsrequiredWebSocket client library for communication with Gabriel server

Agent activity

14 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/cmusatyalab/gabriel ↗

packagehttps://pypi.org/project/gabriel-protocol/ ↗

homepagehttp://gabriel.cs.cmu.edu ↗