omi-collector
Recopilador auto-alojado para extraer audio offline de pendants Omi CV1 vía BLE en servidores Linux. Gestiona recuperación tras interrupciones y corrige desfases temporales, publicando bundles validados para pipelines downstream sin transcribir ni procesar el contenido acústico directamente.
Ficha actualizada 22 sept 2026, 15:09 · upstream 22 sept 2026, 13:46 · release v0.6.8
Qué es omi-collector
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Omi Collector es una herramienta de software open source diseñada para funcionar como un nodo de recolección en servidores Linux. Su función principal es descubrir pendants Omi CV1 cercanos mediante Bluetooth Low Energy (BLE), descargar los registros almacenados en su anillo de búfer y publicar paquetes de audio validados de forma duradera. El proyecto se distingue por mantener la separación entre la captura física del audio y las tareas posteriores como transcripción, diarización o almacenamiento a largo plazo, delegando estas responsabilidades a flujos downstream independientes.
- Automatización de grabación local para entornos domésticos o empresariales sin dependencia de aplicaciones móviles oficiales.
- Alimentación de pipelines de procesamiento de audio externos (ej. Windmill) con archivos fuente validados y cronológicos.
- Archivo persistente de audio que sobrevive a interrupciones de red o reinicios del servicio mediante recuperación automática.
- Corrección de desfases temporales causados por cambios en el reloj del hardware pendant antes de la publicación.
- Recupera automáticamente tras desconexiones y reanuda la descarga sin pérdida de datos.
- Implementa corrección de timestamps para compensar cambios en el reloj del dispositivo pendant.
- Publicación atómica de bundles que garantiza integridad (o nada) para consumidores downstream.
- Requiere Python 3.14+ y uv, con soporte nativo para despliegue como servicio systemd.
- Licencia PolyForm Noncommercial, permitiendo uso en entornos privados sin fines comerciales.
- No transcribe ni procesa audio, actuando exclusivamente como fuente de datos crudos.
- Requiere firmware stock del Omi CV1; no soporta modificaciones o versiones personalizadas del dispositivo.
- Funciona exclusivamente en sistemas Linux con adaptadores BlueZ y controladores Bluetooth operativos.
- No incluye capacidades de transcripción, detección de actividad de voz (VAD) ni almacenamiento de audio procesado.
- El acceso BLE no está endurecido contra clientes cercanos; debe usarse en entornos radiofrecuencia de confianza.
- La configuración de permisos para directorios compartidos requiere gestión manual de ACLs o grupos Unix.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Instalar bajo /opt/omi-collector o /srv/pipelines/omi con cuenta dedicada. Usar scripts install-systemd-unit.sh y deploy-systemd-service.sh. Configurar config.toml con dirección BLE del pendant. Asegurar ACLs en directorio source para acceso downstream. Requiere Python 3.14+ y uv. Verificar estado con omi-collector-status antes de reinicios.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.