{"id":45900722,"url":"https://github.com/bigbluebutton/bbb-livekit-stt","last_synced_at":"2026-02-27T22:43:40.778Z","repository":{"id":339663040,"uuid":"1038218853","full_name":"bigbluebutton/bbb-livekit-stt","owner":"bigbluebutton","description":"Speech-to-Text (STT) for BigBlueButton meetings using LiveKit as their audio bridge","archived":false,"fork":false,"pushed_at":"2026-02-20T20:55:03.000Z","size":171,"stargazers_count":1,"open_issues_count":1,"forks_count":2,"subscribers_count":0,"default_branch":"development","last_synced_at":"2026-02-21T01:45:42.514Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bigbluebutton.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-08-14T20:17:10.000Z","updated_at":"2026-02-20T20:55:06.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/bigbluebutton/bbb-livekit-stt","commit_stats":null,"previous_names":["bigbluebutton/bbb-livekit-stt"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/bigbluebutton/bbb-livekit-stt","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigbluebutton%2Fbbb-livekit-stt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigbluebutton%2Fbbb-livekit-stt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigbluebutton%2Fbbb-livekit-stt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigbluebutton%2Fbbb-livekit-stt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bigbluebutton","download_url":"https://codeload.github.com/bigbluebutton/bbb-livekit-stt/tar.gz/refs/heads/development","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigbluebutton%2Fbbb-livekit-stt/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29917968,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-27T19:37:42.220Z","status":"ssl_error","status_checked_at":"2026-02-27T19:37:41.463Z","response_time":57,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-02-27T22:43:40.280Z","updated_at":"2026-02-27T22:43:40.770Z","avatar_url":"https://github.com/bigbluebutton.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BigBlueButton STT Agent for LiveKit\n\nThis application provides Speech-to-Text (STT) for BigBlueButton meetings using LiveKit\nas their audio bridge.\n\nInitially, the only supported STT engine is Gladia through the official  [LiveKit Gladia Plugin](https://docs.livekit.io/agents/integrations/stt/gladia/).\n\nIt'll be expanded in the future to support other STT plugins from the LiveKit Agents\necosystem.\n\n## Getting Started\n\n### Environment prerequisites\n\n- Python 3.10+\n- A LiveKit instance\n- A Gladia API key\n- uv:\n  - See installation instructions: https://docs.astral.sh/uv/getting-started/installation/\n\n### Installing\n\n1.  **Clone the repository:**\n\n    ```bash\n    git clone git@github.com:bigbluebutton/bbb-livekit-stt.git\n    cd bbb-livekit-stt\n    ```\n\n2.  **Install the dependencies:**\n\n    ```bash\n    uv sync\n    ```\n\n4.  **Configure environment variables:**\n\n    Copy the example `.env` file:\n\n    ```bash\n    cp .env.example .env\n    ```\n\n    Now, edit the `.env` file and fill _at least_ the following environment vars:\n\n    ```\n    LIVEKIT_URL=...\n    LIVEKIT_API_KEY=...\n    LIVEKIT_API_SECRET=...\n\n    # Gladia API Key\n    GLADIA_API_KEY=...\n    ```\n\n    Feel free to check `.env.example` for any other configurations of interest.\n\n    **All options ingested by the Gladia STT plugin are exposed via env vars**.\n\n### Running\n\nThe agent is run using the command-line interface provided by the `livekit-agents`\nlibrary. The necessary environment variables will be  picked up automatically.\n\nOnce started, the worker will connect to your LiveKit server and wait to be assigned\nto rooms. By default, the LiveKit server will dispatch a job to the worker for every\nnew room created. The agent will then join the room, start listening to audio tracks,\nand generate transcription events when required.\n\n#### Development\n\nFor development, use the `dev` command.\n\n```bash\nuv run python3 main.py dev\n```\n\n#### Production\n\nFor production, use the `start` command.\n\n```bash\nuv run python3 main.py start\n```\n\n#### Docker\n\nBuild the image:\n\n```bash\ndocker build . -t bbb-livekit-stt\n```\n\nRun:\n\n```bash\ndocker run --network host --rm -it --env-file .env bbb-livekit-stt\n```\n\nPre-built images are available via GitHub Container Registry as well.\n\n### Development\n\n#### Linting\n\nThis project uses [ruff](https://docs.astral.sh/ruff/) for linting and formatting. To check for issues:\n\n```bash\nuv run ruff check .\n```\n\nTo automatically fix fixable issues:\n\n```bash\nuv run ruff check --fix .\n```\n\nTo format the code:\n\n```bash\nuv run ruff format .\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbigbluebutton%2Fbbb-livekit-stt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbigbluebutton%2Fbbb-livekit-stt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbigbluebutton%2Fbbb-livekit-stt/lists"}