Meshagent
MeshAgent API
The meshagent.api is the foundation that all other packages build on. It includes foundational protocols, JWT authentication, room management, document sync, and more.
JWT Authentication
MeshAgent uses JSON Web Tokens (JWTs) to authenticate participants. A token encodes who you are (participant name) and what you’re allowed to access (project ID, room name, role). The token is signed, so the server can verify it without storing any state.
from meshagent.api import ParticipantToken
token = ParticipantToken(
name="alice",
project_id="your-project-id",
api_key_id="your-api-key-id",
)
token.add_room_grant(room_name="my-room", role="user")
jwt = token.to_jwt(token="your-api-secret")
WebSocket Protocol
A WebSocket keeps a two-way connection open between your Python code and the Meshagent server. This allows instant messaging, file transfers, and document updates. WebSocketClientProtocol manages the underlying connection:
from meshagent.api import WebSocketClientProtocol
protocol = WebSocketClientProtocol(url=room_url, token=jwt)
async with protocol:
# communication occurs over this protocol
Messages are encoded and decoded using a Protocol layer that is transport-agnostic.
RoomClient
RoomClient is the main entry point for interacting with a room. Once you pass in the protocol, the room becomes ready and you gain access to specialized sub-clients:
messaging: send or broadcast text/files.storage: open or write files in the room.sync: collaborate on structured documents.agents: manage agent instances.queues,datasets,livekit, and more.
Document Runtime and Schemas
SyncClient and the document runtime allow multiple participants to edit structured documents (defined by a MeshSchema) with real-time updates propagated via WebSocket messages.
WebhookServer
WebhookServer can run in your own service to receive signed room.call handoffs from MeshAgent.
Meshagent
Separate from rooms, Meshagent is a REST-based client for managing projects, API keys, and secrets. It is useful for administrative tasks.
ServiceHost
ServiceHost allows you to expose agents or tools as an HTTP service. The MeshAgent Server or CLI can invoke the service via webhook calls. The Servicehost spins up the agent or tool, connects it to the specified room, and manages its lifecycle until the call completes or is dismissed. This is how examples like the ChatBot or VoiceBot can be run locally and also enables you to deploy an agent as a MeshAgent Service using the same applicable service path once your agent or tool is ready.
When a call to the agent or tool arrives through a webhook, the ServiceHost spawns that agent or tool and connects it to the requested room via the RoomClient and WebSocketClientProtocol. The ServiceHost starts an HTTP servier and registers each path so that multiple agents or toolkits can be hosted.
from meshagent.api.services import ServiceHost
service = ServiceHost() # port defaults to an available port if not assigned
@service.path("/chat")
class SimpleChatbot(ChatBot):
...
print(f"running on port {service.port}")
asyncio.run(service.run())
Learn more about MeshAgent on our website or check out the docs for additional examples!
Website: www.meshagent.com
Documentation: docs.meshagent.com
1 maintainer
Metadata
1 maintainer
Release files for meshagent-api 0.53.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| meshagent_api-0.53.1.tar.gz | 239.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| meshagent_api-0.53.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 498.0 kB
Release files / meshagent_api-0.53.1.tar.gz
| Download URL | meshagent_api-0.53.1.tar.gz |
|---|---|
| Size | 239.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
91f6aadac5063f2aa0e62c85bb7999adc52f1a908c29b42d05ee1d7708c09fbe
|
|
BLAKE2b-256 checksum How to use checksums |
e688ad5246012a304496509c523ae9b4391328525242db6f06a2869c5a359bca
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / meshagent_api-0.53.1-py3-none-any.whl
| Download URL | meshagent_api-0.53.1-py3-none-any.whl |
|---|---|
| Size | 258.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0fea5104f778cc6a6fbcbc7f4f9869ad854550b2ade52876fa678d06b901eebd
|
|
BLAKE2b-256 checksum How to use checksums |
f985c6a357bbf1b56af28c52950c10fe40c96e3010d0ef63208d296bdd6463a1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
