Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

TranslationRoomIO: unset_track() before a track is linked stalls startup, so the translation is never published

Aperta
  • Qualcosa non va?
#8,114 1 commento 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

@RaphaelFakhri ci sta già lavorando.

Dal 24/10/2026.

  • #8115 di @RaphaelFakhri — aperta

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
20/100
Tipo di issue
Bug
Chiarezza
Specificata chiaramente
Stato di attività
Ferma
Stack tecnologico
python
Ambito
audio-video-rtc, backend

Direzione di ricerca

Start by reading TranslationRoomIO.unset_track(), set_track(), and _on_track_published to trace how _track_available_fut is replaced and resolved. The issue says a regression test is ready; run it alongside the relevant TranslationRoomIO tests. Done means linking a track after unset_track() allows startup to finish, the translated track to publish, and wait_for_ready() to return.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

Bug Description

TranslationRoomIO.unset_track() always replaces _track_available_fut with a new future. If no track has been linked yet, _init_task is still awaiting the original future, and that future is never resolved.

If a track is later linked with set_track(sid) or by auto-selection, _on_track_published resolves only the new future. Because _init_task is not done, it also skips _apply_link. Startup stays blocked:

  • the translated audio track is never published,
  • the input transcription output is never created,
  • TranslationRoomIO.wait_for_ready() never returns.
Reproduction Steps
  1. Start a TranslationSession with a room, before any eligible audio track is published.
  2. Call session.room_io.unset_track() to wait for an explicit choice, then session.room_io.set_track("TR_x").
  3. Publish TR_x. Its audio reaches the model, but the session never publishes the translated track, and wait_for_ready() hangs.
Expected Behavior

A track linked after unset_track() completes startup the same way the first linked track does.

Operating System

Linux

Models Used

Any TranslationModel

Package Versions

livekit-agents 1.8.9 (main at d4de578)

Proposed Solution

In unset_track(), replace _track_available_fut only when it is already done, as set_track() does. A fix with a regression test is ready.

Lingua principale
Python
Stelle
14.6k
Fork
3.9k
Merge medio
3g 11h
PR unite (30g)
196

Preparare l'ambiente

Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di livekit/agents

Tutte le issue di livekit/agents

Issue simili

Altre issue su Python

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.