Usá Co-host Agenda Mode cuando Kira tenga que sostener el stream sin tomar el control.
El modo co-host no es autonomía total. El streamer prepara o aprueba la dirección, y Kira ayuda con ritmo, transiciones, turnos cortos y reacciones compactas del chat dentro de ese carril.
Pensá a Kira como una co-host de radio con una escaleta preparada. Vos elegís el segmento, Kira ayuda a mantenerlo vivo, y el host puede interrumpirla o frenarla en cualquier momento.
Cómo fluye un segmento co-host
El host elige tema
La dirección del stream empieza con una idea aprobada por una persona.
Kira abre
Kira hace una intro o transición corta, no una clase eterna.
Llegan señales live
PTT, input del host, resumen de chat y timers pueden cambiar el siguiente turno.
Stop seguro
El host puede pausar o cortar el segmento sin perder control.
Camino rápido
- 1Prepará pocos temas aprobados por el streamer, con título, ángulo y restricciones.
- 2Activá Co-host Agenda Mode solo cuando el host quiera que Kira ayude a conducir el segmento.
- 3Dejá que Kira abra el tema activo, hable en turnos cortos y espere PTT, chat compactado o señales de timer.
- 4Usá soft stop en límites seguros; usá emergency stop solo cuando haya que cortar habla o generación.
Qué controla el modo
Dirección humana
Kira no inventa el plan del show. Los temas y la dirección se aprueban primero por el streamer.
Turnos cortos
Cada intervención debería encajar en el ritmo del vivo: una idea, una transición o una reacción.
Prioridad de entradas
PTT y entrada directa del host pesan más que chat; chat se filtra y compacta antes de entrar como contexto.
Recuperación segura
Stop y retry respetan límites de habla/generación para degradar el show en vez de bloquearlo.
Cuándo sirve / cuándo no
Usalo cuando
Tenés un segmento planeado y querés que Kira ayude con ritmo, transiciones y reacciones livianas.
Evitá usarlo cuando
Querés hablar libremente sin agenda guiada por IA, o cuando el tema todavía no está aprobado.
Notas para desarrolladores
No construyas autonomía infinita
Chat es una señal secundaria
Las cards enriquecen el modo directo
Las cards son contexto curado para Kira, no temas de agenda.
Usá cards para guardar una postura, gancho, contrapunto o ángulo de investigación que Kira pueda inyectar cuando aparezca un tema o una pregunta directa del host que coincida.
Una card es una nota adhesiva para Kira. Le dice: "si aparece este tema, acordate de este punto preparado". No es todo el plan del stream.
Ciclo de vida de una card
Draft
Escribís la idea mientras todavía está oculta para Kira.
Arm
La marcás como lista para que Kira pueda usarla cuando llegue el momento.
Match o link
Se adjunta por triggers o la vinculás manualmente a un topic.
Usar o rearmar
Conservás historial, desactivás notas viejas o rearmás conocimiento útil.
Camino rápido
- 1Creá una card con topic, resumen, postura del streamer, contrapuntos opcionales, hooks, triggers y expiración.
- 2Armá la card cuando esté lista. Las cards en DRAFT son invisibles para Kira.
- 3Dejá que auto-attach vincule una card ARMED a un tema de agenda, o usá link como override determinístico.
- 4Usá rearm para conocimiento reutilizable, disable para cards obsoletas y delete solo cuando quieras borrado duro.
Ciclo de vida
DRAFT
Editable e invisible para Kira. Estado seguro de preparación para humanos y agentes.
ARMED
Disponible para auto-attach, inyección en entrada directa del host o link explícito.
ACTIVE / USED
ACTIVE significa seleccionada para un tema; USED conserva historial después de que Kira la consume.
EXPIRED
Queda fuera del matching. Puede rearmarse si el contenido vuelve a ser útil otra vez.
Qué debería escribir un usuario
Escribí el punto
Mantené la card enfocada: una postura, un gancho, un dato útil o un contrapunto.
Agregá triggers
Sumá nombres, juegos, temas y frases que el host realmente podría decir en vivo.
No pegues investigación cruda
Resumí primero. Kira necesita una señal clara para el vivo, no una pared de notas.
Reglas que importan
Cards vs topics
Los triggers importan
Chat nunca dispara inyección de cards
Link debe coincidir con el slug
Usá la CLI para flujos repetibles de cards y topic inbox.
La CLI editorial es un proceso one-shot: cada comando abre SQLite, hace una transacción, imprime y sale. Eso la vuelve segura para automatización y scripts controlados.
La mayoría de streamers no necesita la CLI. Es para operadores, scripts y agentes que preparan cards o sugerencias de topics de forma repetible.
Flujo seguro con CLI
Preparar
Una persona, script o agente crea una card chica o propuesta de topic.
Validar
La CLI acepta solo input acotado y curado, con errores claros.
Revisar
Las propuestas de topic todavía necesitan revisión humana en la app.
Usar en vivo
El contenido aprobado puede asistir a Kira durante el stream.
Camino rápido
- 1Corré los comandos desde la raíz del repo o desde el entorno Python empaquetado.
- 2Usá --json para agentes y parseá stderr cuando el exit code sea distinto de cero.
- 3Tratá exit 1 como un resultado decidido de validación/estado, no como algo para reintentar a ciegas.
- 4Reintentá solo fallos transitorios "database is locked", con backoff.
Quién debería usarla
Streamer
Usá primero la UI de la app. Es el camino más seguro y claro para operar en vivo.
Operador
Usá la CLI para preparar muchas cards o propuestas antes del show.
Agente/script
Usá --json, revisá exit codes y nunca asumas que un topic quedó aprobado.
Comandos comunes
python -m opencohost.editorial_cli --json create --from-jsonpython -m opencohost.editorial_cli arm <card_id>
python -m opencohost.editorial_cli show <card_id> --jsonpython -m opencohost.editorial_cli link <topic_slug> <card_id>python -m opencohost.editorial_cli topic propose --title "<title>" --angle "<angle>" --source "<agent>"python -m opencohost.editorial_cli topic list --json
python -m opencohost.editorial_cli topic discard <ti_id>Límites duros
No hay aprobación de topics por CLI
Solo contexto curado
Una operación por proceso
Conectá avatar por OBS y chat por link; mantené Stream Admin restringido.
OpenCohost debe simplificar integraciones de stream sin pedir credenciales peligrosas por defecto. Avatar y chat por link son el camino seguro; Stream Admin queda como MVP restringido/de pruebas.
Hay dos conexiones normales: OBS muestra a Kira visualmente, y el link de chat le permite entender la sala. Stream Admin es distinto: puede tocar controles del canal, por eso queda restringido.
Mapa seguro de conexión al stream
Avatar OBS
Solo estado visual: Kira cambia imagen/estado dentro de OBS.
URL de chat
Lee el chat en vivo desde un link de YouTube/Twitch.
OpenCohost
Convierte señales en contexto seguro para Kira.
Stream Admin
MVP restringido para pruebas admin privilegiadas, no el flujo normal de chat.
Camino rápido
- 1Para el avatar, activá OBS WebSocket, creá una fuente Image llamada KiraAvatar y configurá host, port, password, source y scene desde el panel de avatar o config/avatar.yaml.
- 2Usá "Test connection" antes de salir en vivo. El avatar bridge actualiza fuentes de imagen en OBS cuando cambia el estado de Kira.
- 3Para chat, pegá el link del live/chat de YouTube o Twitch en el campo de conexión de chat. Este camino es solo por link y no debe pedir permisos OAuth de escritura.
- 4Mantené Stream Admin deshabilitado/restringido salvo que estés probando explícitamente flujos admin MVP con credenciales aprobadas o descartables.
Features destacadas
Avatar por OBS
Kira puede exponer estados idle, listening, thinking, speaking y relacionados actualizando fuentes de imagen en OBS.
Chat solo por URL
El streamer pega un link de live/chat de YouTube o Twitch; OpenCohost lo trata como fuente de chat, no como administración del canal.
Soporte Stream Chico
Stream Chico baja thresholds/cooldowns para que salas pequeñas también generen momentos útiles de co-host.
Stream Admin MVP
OAuth y operaciones admin siguen restringidas, gated por aprobación y orientadas a pruebas porque los permisos de escritura son de alto riesgo.
Seguro vs restringido
Seguro por defecto
Avatar OBS y chat por link son el camino normal para usuarios.
Restringido
OAuth y acciones admin son solo modo prueba y requieren aprobación explícita.
No prometas
No describas Stream Admin como control general del canal hasta que esté validado y publicado.