chert create-room starts a long-running connector; it creates a room when a call arrives, not at startup.
This private-preview adapter requires a qualified agent integration. An arbitrary LiveKit agent or an existing webhook URL is not enough. For application-owned sessions, use the Custom BYOR callbacks.
Before you start
- Complete manual connector enrollment for create-room mode; use Node 22.12+ (22.x), 24.x or 26.x on macOS or Linux with durable local storage.
- Run a named LiveKit agent with a verified
chert-adapter-v1health/cancellation hook on the same host, listening on literal loopback (127.0.0.1). - Obtain the exact agent name, deployment identifier, boot identifier, LiveKit URL, and hook port from that integration.
- Supply
LIVEKIT_API_KEY,LIVEKIT_API_SECRET, andCHERT_HOOK_SECRETsecurely to the connector process. Do not put secret values in command arguments or source control.
1. Install and initialize
Install the published package in your application:2. Check the integration
Start your agent, then run:3. Enroll and start
Follow Manual connector enrollment, usingchert-room.json as the base config and a fresh output config such as chert-room.enrolled.json. Use create-room instead of byor when starting the connector:
Current limits
Preparation must finish within the supplied call deadline; the adapter enforces a maximum 60-second resource lifetime, with one active call at a time. This adapter supports audio only; that restriction does not apply tochert dev or chert byor, which
support audio and video. Use BYOR for application-managed session lifetimes; changing modes requires a fresh config, state directory, and enrollment.
