Bedrud Documentation

Bedrud inclut des agents bot basés sur Python qui peuvent rejoindre des meeting rooms et stream media content. Ces bots sont utiles pour background music, radio streams, ou sharing video content.

Available Agents

AgentDescriptionMedia Type
music_agentPlays audio files into a roomAudio (PCM)
radio_agentStreams internet radio stationsAudio (PCM via FFmpeg)
video_stream_agentShares video content (HLS, MP4)Video + Audio

How Agents Work

Tous les agents suivent le même connection pattern :

flowchart TD
    A[1. Parse meeting URL] --> B[2. Guest login<br/>POST /api/auth/guest-login]
    B --> C[3. Join room<br/>POST /api/room/join]
    C --> D[4. Connect to LiveKit<br/>WebSocket + Token]
    D --> E[5. Publish tracks<br/>Stream audio/video frames]
flowchart LR
    subgraph Media["Media Source"]
        MS["File / URL<br/>(MP3, radio, HLS, MP4)"]
    end
    subgraph Agent["Python Agent"]
        FF[FFmpeg Decoder]
        PA[Agent Logic]
    end
    subgraph Server["Bedrud Server"]
        GL[Guest Login<br/>/api/auth/guest-login]
        JR[Join Room<br/>/api/room/join]
    end
    subgraph LK["LiveKit SFU<br/>(WebRTC)"]
        WS[WebSocket Connect]
        PT[Publish Tracks]
    end
    MS --> FF --> PA
    PA --> GL
    GL --> JR
    JR --> WS
    WS --> PT

Music Agent

Lit des fichiers audio (MP3, WAV, etc.) dans une meeting room.

Setup

cd agents/music_agent
pip install -r requirements.txt

Dependencies : httpx, livekit, pydub

Usage

python agent.py "https://meet.example.com/m/room-name"

How It Works

  1. Décode les fichiers audio en utilisant pydub
  2. Convertit en PCM frames
  3. Publie les audio frames vers LiveKit comme microphone track

Voir Music Agent README pour les setup et usage instructions.

Radio Agent

Streams des internet radio stations dans une meeting room en utilisant FFmpeg pour audio decoding.

Setup

cd agents/radio_agent
pip install -r requirements.txt

Dependencies : httpx, livekit

System requirement : FFmpeg doit être installé (brew install ffmpeg ou apt install ffmpeg)

Usage

python agent.py "https://meet.example.com/m/room-name"

How It Works

  1. Se connecte à une radio stream URL
  2. Pipes le stream à travers FFmpeg pour decoder en raw PCM
  3. Publie les PCM audio frames vers LiveKit

Voir Radio Agent README pour les setup et usage instructions.

Video Stream Agent

Shares video et audio depuis une URL (HLS/m3u8, MP4) dans une meeting room.

Setup

cd agents/video_stream_agent
pip install -r requirements.txt

Dependencies : httpx, livekit

System requirement : FFmpeg doit être installé

Usage

python agent.py "https://meet.example.com/m/room-name"

How It Works

  1. Runs deux FFmpeg processes en parallèle :
    • Video : Décode en YUV420p raw frames (1280x720 @ 30fps)
    • Audio : Décode en PCM samples
  2. Publie la vidéo comme screen share track
  3. Publie l’audio comme microphone track

Voir Video Stream Agent README pour les setup et usage instructions.

Video Specifications

SettingValue
Width1280
Height720
FPS30
Pixel FormatYUV420p

Writing a Custom Agent

Pour créer un nouvel agent, suivez ce pattern :

import httpx
from livekit import rtc
 
# 1. Parse la meeting URL pour extraire le room name
room_name = parse_url(meeting_url)
 
# 2. Guest login
client = httpx.Client(base_url=server_url)
resp = client.post("/api/auth/guest-login", json={"name": "Bot Name"})
token = resp.json()["token"]
 
# 3. Join room
client.headers["Authorization"] = f"Bearer {token}"
resp = client.post("/api/room/join", json={"roomName": room_name})
lk_token = resp.json()["token"]
 
# 4. Connect to LiveKit
room = rtc.Room()
await room.connect(livekit_url, lk_token)
 
# 5. Publish tracks
source = rtc.AudioSource(sample_rate=48000, num_channels=1)
track = rtc.LocalAudioTrack.create_audio_track("audio", source)
await room.local_participant.publish_track(track)
 
# 6. Stream frames
while has_data:
    frame = get_next_frame()
    await source.capture_frame(frame)

See also