⬟ SL5 Aura – Tu Voz. Tus reglas.¶
Marco de asistente de voz 100% fuera de línea y que prioriza la privacidad.
Defina exactamente lo que hace su voz, a partir de una sola palabra
a scripts completos de Python. Ninguna nube. No salen datos de su máquina.
Se ejecuta en terminal, navegador o como servicio en segundo plano (en Linux, macOS y Windows).
👵 Principiante |
🎓 Aprendiz |
🧑u200d💻 Desarrollador |
|---|
| grandma-mode: sólo escribe una palabra, Aura hace el resto | Aprenda con Koans: un concepto a la vez | Secuencias de comandos Python completas, complementos, llamadas API | | 🗄️Gestión Estatal | Trino + Orquestación de flujo de aire, fzf, CopyQ, comandos de voz/terminal, interfaces de usuario del navegador |
⚡ ~2,87 J por prueba (39 pruebas en >800 mapas a 0,09 s cálido/0,45 s frío 🌿 medido con Eco-CI) · sin computación en la nube
Inicio rápido¶
Descarga o clona este repositorio
Ejecute el script de configuración para su sistema operativo (consulte la carpeta
setup/):
Linux (Arch/Manjaro):
bash setup/manjaro_arch_setup.sh===> 🧩 leer docs/LINUX_WAYLAND_dotoolLinux (Ubuntu/Debian):
bash setup/ubuntu_setup.shLinux (openSUSE):
bash setup/suse_setup.shLinux (NixOS):
nix-shell setup/shell.nixy luegobash setup/nixos_setup.sh===> ⚠️ Experimental: no probado por los autores, ¡recibimos comentarios!macOS:
bash setup/macos_setup.shWindows:
setup/windows11_setup_with_ahk_copyq.bat
Inicie Aura:
./scripts/restart_venv_and_run-server.shPresione su tecla de acceso rápido y hable: full guide →
⚠️ Requisitos del sistema y compatibilidad
Windows: ✅ Totalmente compatible (usa AutoHotkey/PowerShell).
macOS: ✅ Totalmente compatible (usa AppleScript).
Linux (X11/Xorg): ✅ Totalmente compatible.
Linux (Wayland): ✅ Totalmente compatible (probado en KDE Plasma 6/Wayland).
Linux (versión continua basada en CachyOS/Arch): ✅ Totalmente compatible. Requiere mimalloc (
sudo pacman -S mimalloc) debido a la compatibilidad con glibc 2.43.Linux (NixOS): 🧪 Experimental: configuración aportada por la comunidad, aún no probada. Si lo prueba, abra un problema o PR con sus hallazgos.
Linux (Manjaro): Nuevo/experimental: una tecla de acceso rápido en todo el sistema abre una interfaz controlada por teclado similar a fzf para que pueda ejecutar comandos de Aura desde cualquier lugar del escritorio (completamente desacoplada de la ventana activa). Este iniciador controlado por teclas de acceso rápido está actualmente implementado y probado en Linux (Manjaro); Otras distribuciones pueden funcionar pero requieren configuración. Ver en 👉 docs/Feature_Spotlight/CopyQ_Shortcut_Super_s.md
SL5 Aura es un completo asistente de voz fuera de línea integrado en Vosk (para voz a texto) y LanguageTool (para gramática/estilo), que presenta un Reserva local de LLM (Ollama) opcional para respuestas creativas y concordancia difusa avanzada. Transforma su voz en acciones y texto precisos, diseñados para una máxima personalización a través de un sistema de reglas conectable y un motor de secuencias de comandos dinámico.
Traducciones: Este documento también existe en other languages.
Nota: Muchos textos son traducciones generadas automáticamente de la documentación original en inglés y están destinados únicamente a proporcionar orientación general. En caso de discrepancias o ambigüedades, siempre prevalecerá la versión en inglés. ¡Agradecemos la ayuda de la comunidad para mejorar esta traducción!
📺 Demostración de terminal¶
Consejo: Para una mejor experiencia de terminal, consulte Zsh Integration.
🎥 Vídeotutorial¶
(Enlace alternativo: skipvids.com)
Características clave¶
Sin conexión y privado: 100% local. Ningún dato sale nunca de su máquina.
Motor de scripting dinámico: Vaya más allá del reemplazo de texto. Las reglas pueden ejecutar secuencias de comandos Python personalizadas (
on_match_exec) para realizar acciones avanzadas como llamar a API (por ejemplo, buscar en Wikipedia), interactuar con archivos (por ejemplo, administrar una lista de tareas pendientes) o generar contenido dinámico (por ejemplo, un saludo por correo electrónico contextual).Reglas contextuales: Restringe las reglas a aplicaciones específicas. Al usar
only_in_windows, puede garantizar que una regla solo se active si un título de ventana específico (por ejemplo, “Terminal”, “Código VS” o “Navegador”) está activo. Esto funciona multiplataforma (Linux, Windows, macOS).Motor de transformación de alto control: Implementa un proceso de procesamiento altamente personalizable y basado en configuración. La prioridad de las reglas, la detección de comandos y las transformaciones de texto están determinadas exclusivamente por el orden secuencial de las reglas en Fuzzy Maps, lo que requiere configuración, no codificación.
Uso conservador de RAM: Administra de forma inteligente la memoria, precargando modelos solo si hay suficiente RAM libre disponible, lo que garantiza que otras aplicaciones (como los juegos de PC) siempre tengan prioridad.
Multiplataforma: Funciona en Linux, macOS y Windows.
Totalmente automatizado: Administra su propio servidor LanguageTool (pero también puede usar uno externo).
Increíblemente rápido: El almacenamiento en caché inteligente garantiza notificaciones instantáneas de “escucha…” y un procesamiento rápido.
Gestión dinámica del estado a través de Trino: Motor de configuración compatible con la interfaz separa las configuraciones para
voz,terminalyweb; cambie una sin afectando a los demás. Incluye un Panel de administración en tiempo real (puerto 8084).
🔌 Integraciones listas para usar¶
SL5-Aura viene con un vasto ecosistema de más de 100+ complementos preconfigurados. Aquí hay algunos aspectos destacados:
Control de voz OculiX / SikuliX IDE¶
SL5-Aura proporciona soporte de voz de primera clase para OculiX y SikuliX IDE. Esta integración le permite “decir” su código de automatización.
Voice-to-Snippet: Diga “hacer clic”, “esperar” o “buscar todo” y el servicio escribirá instantáneamente el código Python correcto (por ejemplo,
hacer clic("image.png")) en el IDE.Consciente de ventanas: El complemento es sensible al contexto; solo se activa cuando la ventana de OculiX/SikuliX está enfocada.
Soporte de inglés inteligente: Optimizado para
en-UScon un enfoque especial en acentos no nativos (por ejemplo, fonética alemán-inglés), lo que garantiza una alta precisión de reconocimiento para la comunidad global.Extensible: Utiliza el formato
FUZZY_MAP_pre.pyfácil de editar.
Estado: Reconocido como complemento comunitario por el equipo de OculiX (ver Issue #204).
Control por voz de LibreOffice IDE¶
0 A.D. Control por voz¶
Documentación¶
Para obtener una referencia técnica completa, incluidos todos los módulos y scripts, visite nuestra página de documentación oficial. Se genera automáticamente y siempre está actualizado.
👉Go to Documentation sl5net.github.io/SL5-aura-service
Funciones destacadas¶
Interactive Rule Search & Run: búsqueda de reglas
fzfde doble panel, vistas previas de contexto en vivo, ejecución instantánea de comandos medianteEnter/Ctrl+Re integración del editor medianteCtrl+E. Compatible con una tecla de acceso rápido global (Super+S) y múltiples entornos de búsqueda dedicados preconfigurados mediante comandos de voz.
Estado de compilación¶
👉 Lea esto en otros idiomas:
🇬🇧 English | 🇸🇦 العربية | 🇩🇪 Deutsch | 🇪🇸 Español | 🇫🇷 Français | 🇮🇳 हिन्दी | 🇯🇵 日本語 | 🇰🇷 한국어 | 🇵🇱 Polski | 🇵🇹 Português | 🇧🇷 Português Brasil | 🇨🇳 简体中文
Instalación¶
🎥 Instalación rápida sin moderación (Manjaro/Arch Video)¶
Vea el proceso de configuración completo de 6 minutos:
Descargar: ~3 minutos
Configuración y primer inicio: ~3 minutos (incluido el asistente de bienvenida)
👉 SL5 Aura Installation Live-Demo on YouTube
La configuración es un proceso de dos pasos:
Descargue la última versión o master (https://github.com/sl5net/SL5-aura-service/archive/master.zip) o clone este repositorio en su computadora.
Ejecute el script de configuración única para su sistema operativo.
Los scripts de configuración manejan todo: dependencias del sistema, entorno Python y descarga de los modelos y herramientas necesarios (~4 GB) directamente desde nuestras versiones de GitHub para obtener la máxima velocidad.
Para Linux, macOS y Windows (con exclusión de idioma opcional)¶
Para ahorrar espacio en disco y ancho de banda, puede excluir modelos de idiomas específicos (de, en) o todos los modelos opcionales (all) durante la instalación. Los componentes principales (LanguageTool, lid.176) siempre están incluidos.
Abra una terminal en el directorio raíz del proyecto y ejecute el script para su sistema:
# For Ubuntu/Debian, Manjaro/Arch, macOS, or other derivatives
# (Note: Use bash or sh to execute the setup script)
bash setup/{your-os}_setup.sh [OPTION]
# For Arch-based systems (Manjaro, CachyOS, EndeavourOS, etc.):
`bash setup/manjaro_arch_setup.sh`
`sudo pacman -S mimalloc`
# Examples:
# Install everything (Default):
# bash setup/manjaro_arch_setup.sh
# Exclude German models:
# bash setup/manjaro_arch_setup.sh exclude=de
# Exclude all VOSK language models:
# bash setup/manjaro_arch_setup.sh exclude=all
# For Windows in an Admin-Powershell session
setup/windows11_setup.ps1 -Exclude [OPTION]
# Examples:
# Install everything (Default):
# setup/windows11_setup.ps1
# Exclude English models:
# setup/windows11_setup.ps1 -Exclude "en"
# Exclude German and English models:
# setup/windows11_setup.ps1 -Exclude "de,en"
# Or (recommend) - Run the BAT file:
windows11_setup.bat -Exclude "en"
Para Windows¶
Ejecute el script de configuración con privilegios de administrador.
Instale una herramienta para leer y ejecutar, por ejemplo, CopyQ o AutoHotkey v2. Esto es necesario para el observador de escritura de texto.
La instalación es totalmente automatizada y tarda entre 8 y 10 minutos cuando se utilizan 2 modelos en un sistema nuevo.
Navegue hasta la carpeta
setup.Haga doble clic en
windows11_setup_with_ahk_copyq.bat.
El script solicitará automáticamente privilegios de administrador.
Instala el sistema central, los modelos de lenguaje, AutoHotkey v2 y CopyQ.
Una vez que se complete la instalación, Aura Dictation se iniciará automáticamente.
Nota: No es necesario instalar Python o Git de antemano; el guión se encarga de todo.
Instalación avanzada/personalizada¶
Si prefiere no instalar las herramientas del cliente (AHK/CopyQ) o desea ahorrar espacio en disco excluyendo idiomas específicos, puede ejecutar el script principal a través de la línea de comando:
# Core Setup only (No AHK, No CopyQ)
setup/windows11_setup_with_ahk_copyq.bat
# Exclude specific language models (saves space):
# Exclude English:
setup/windows11_setup_with_ahk_copyq.bat -Exclude "en"
# Exclude German and English:
setup/windows11_setup_with_ahk_copyq.bat -Exclude "de,en"
Uso¶
1. Iniciar los servicios¶
En Linux y macOS¶
Un único script se encarga de todo. Inicia el servicio de dictado principal y el observador de archivos automáticamente en segundo plano.
# Run this from the project's root directory
./scripts/restart_venv_and_run-server.sh
En Windows¶
Iniciar el servicio es un proceso manual de dos pasos:
Inicie el servicio principal: Ejecute
start_aura.bat. o iniciar desde.venvel servicio conpython3
2. Configura tu tecla de acceso rápido¶
Para activar el dictado, necesita una tecla de acceso rápido global que cree un archivo específico. Recomendamos encarecidamente la herramienta multiplataforma CopyQ.
Nuestra recomendación: CopyQ¶
Cree un nuevo comando en CopyQ con un acceso directo global.
Comando para Linux/macOS:
touch /tmp/sl5_record.trigger
Comando para Windows cuando se usa CopyQ:
copyq:
var filePath = 'c:/tmp/sl5_record.trigger';
var f = File(filePath);
if (f.openAppend()) {
f.close();
} else {
popup(
'error',
'cant read or open:\n' + filePath
+ '\n' + f.errorString()
);
}
Comando para Windows cuando se usa AutoHotkey:
; trigger-hotkeys.ahk
; AutoHotkey v2 Skript
#SingleInstance Force ; Stellt sicher, dass nur eine Instanz des Skripts läuft
;===================================================================
; Hotkey zum Auslösen des Aura Triggers
; Drücke Strg + Alt + T, um die Trigger-Datei zu schreiben.
;===================================================================
f9::
f10::
f11::
{
local TriggerFile := "c:\tmp\sl5_record.trigger"
FileAppend("t", TriggerFile)
ToolTip("Aura Trigger ausgelöst!")
SetTimer(() => ToolTip(), -1500)
}
3. ¡Empieza a dictar!¶
Haga clic en cualquier campo de texto, presione la tecla de acceso rápido y aparecerá una notificación “Escuchando…”. Habla con claridad y luego haz una pausa. El texto corregido se escribirá por usted.
Configuración avanzada (opcional)¶
Puede personalizar el comportamiento de la aplicación creando un archivo de configuración local.
Navegue hasta el directorio
config/.Cree una copia de
config/settings_local.py_Example.txty cámbiele el nombre aconfig/settings_local.py.Edite
config/settings_local.py(anula cualquier configuración del archivo principalconfig/settings.py).
Git ignora este archivo config/settings_local.py de forma predeterminada, por lo que sus cambios personales no serán sobrescritos por las actualizaciones.
Estructura y lógica del complemento¶
La modularidad del sistema permite una extensión sólida a través del directorio plugins/.
El motor de procesamiento se adhiere estrictamente a una Cadena de prioridad jerárquica:
Orden de carga de módulos (prioridad alta): Las reglas cargadas desde los paquetes de idiomas principales (de-DE, en-US) tienen prioridad sobre las reglas cargadas desde el directorio plugins/ (que se cargan en último lugar alfabéticamente).
Orden en el archivo (microprioridad): Dentro de cualquier archivo de mapa determinado (FUZZY_MAP_pre.py), las reglas se procesan estrictamente por número de línea (de arriba a abajo).
Esta arquitectura garantiza que las reglas centrales del sistema estén protegidas, mientras que las reglas específicas del proyecto o que tienen en cuenta el contexto (como las de CodeIgniter o los controles del juego) se pueden agregar fácilmente como extensiones de baja prioridad mediante complementos.
Scripts clave para usuarios de Windows¶
Aquí hay una lista de los scripts más importantes para configurar, actualizar y ejecutar la aplicación en un sistema Windows.
Configuración y actualización¶
chmod +x actualización.sh; ./actualización.shsetup/setup.bat: El script principal para la configuración inicial única del entorno.or
Ejecute powershell -Command "Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process -Force; .\setup\windows11_setup.ps1"update.bat: ejecuta esto desde la carpeta del proyecto para obtener el código y las dependencias más recientes.
Ejecutando la aplicación¶
start_aura.bat: Un script principal para iniciar el servicio de dictado.
Scripts principales y auxiliares¶
aura_engine.py: El servicio principal de Python (generalmente iniciado por uno de los scripts anteriores).get_suggestions.py: un script auxiliar para funcionalidades específicas.
🚀 Funciones clave y compatibilidad con el sistema operativo¶
Leyenda de compatibilidad del sistema operativo:
🐧 Linux (por ejemplo, Arch, Ubuntu)
🍏 macOS
🪟 Windows
📱 Android (para funciones específicas de dispositivos móviles)
Motor principal de conversión de voz a texto (Aura)¶
Nuestro motor principal para el reconocimiento de voz y el procesamiento de audio sin conexión.
SystemUtilities/
├┬ LanguageTool Server Management/
│├─ start_languagetool_server.py (Initializes the local LanguageTool server) 🐧 🍏 🪟
│└─ stop_languagetool_server.py (Shuts down the LanguageTool server) 🐧 🍏
├─ monitor_mic.sh (e.g. for use with Headset without use keyboard and Monitor) 🐧 🍏 🪟
Model & Package Management¶
Tools for robust handling of large language models.
ModelManagement/ 🐧 🍏 🪟
├─ Robust Model Downloader (GitHub Release chunks) 🐧 🍏 🪟
├─ split_and_hash.py (Utility for repo owners to split large files and generate checksums) 🐧 🍏 🪟
└─ download_all_packages.py (Tool for end-users to download, verify, and reassemble multi-part files) 🐧 🍏 🪟
</detalles>
<detalles>
<summary>Ayudantes de desarrollo e implementación</summary>
### **Ayudantes de desarrollo e implementación**
Scripts para la configuración, prueba y ejecución del servicio del entorno.
*Consejo: glogg le permite utilizar expresiones regulares para buscar eventos interesantes en sus archivos de registro.*
Marque la casilla de verificación durante la instalación para asociar con archivos de registro.
https://translate.google.com/translate?hl=en&sl=en&tl=es&u=https://glogg.bonnefon.org/
*Consejo: Después de definir sus patrones de expresiones regulares, ejecute `python3 tools/map_tagger.py` para generar automáticamente ejemplos de búsqueda para las herramientas CLI. Consulte [Map Maintenance Tools](../docs/Developer_Guide/Map_Maintenance_Tools.i18n/Map_Maintenance_Tools-eslang.md) para obtener más detalles.*
Entonces tal vez haga doble clic
`log/aura_engine.log`
**DevHelpers/**
├┬ **Gestión del entorno virtual/**
│├ `scripts/restart_venv_and_run-server.sh` (Linux/macOS) 🐧 🍏
│└ `scripts/restart_venv_and_run-server.ahk` (Windows) 🪟
├┬ **Integración de dictado en todo el sistema/**
│├ Integración Vosk-System-Listener 🐧 🍏 🪟
│├ `scripts/monitor_mic.sh` (monitoreo de micrófono específico de Linux) 🐧
│└ `scripts/type_watcher.ahk` (AutoHotkey escucha el texto reconocido y lo escribe en todo el sistema) 🪟
└─ **Automatización CI/CD/**
└─ Flujos de trabajo de GitHub ampliados (instalación, pruebas, implementación de documentos) 🐧 🍏 🪟 *(Se ejecuta en GitHub Actions)*
</detalles>
<detalles>
<summary>Características experimentales</summary>
### **Próximas funciones/experimentales**
Funciones actualmente en desarrollo o en estado de borrador.
**Características experimentales/**
├─ **ENTER_AFTER_DICTATION_REGEX** Ejemplo de regla de activación "(ExampleAplicationThatNotExist|Pi, tu IA personal)" 🐧
├┬Complementos
│╰┬ **Live Lazy-Reload** (*) 🐧 🍏 🪟
(*Los cambios en la activación/desactivación del complemento y sus configuraciones se aplican en la siguiente ejecución del procesamiento sin reiniciar el servicio.*)
│ ├ **comandos git** (control de voz para enviar comandos git) 🐧 🍏 🪟
│ ├ **wannweil** (Mapa de ubicación Alemania-Wannweil) 🐧 🍏 🪟
│ ├ **Complemento de póquer (Draft)** (Control por voz para aplicaciones de póquer) 🐧 🍏 🪟
│ └ **Complemento 0 A.D. (borrador)** (control por voz para el juego 0 A.D.) 🐧
├─ **Salida de sonido al iniciar o finalizar una sesión** (Descripción pendiente) 🐧
├─ **Salida de voz para personas con discapacidad visual** (Descripción pendiente) 🐧 🍏 🪟
└─ **Prototipo de Android SL5 Aura** (Aún no está completamente fuera de línea) 📱
---
*(Nota: Distribuciones de Linux específicas como Arch (ARL) o Ubuntu (UBT) están cubiertas por el símbolo general de Linux 🐧. Es posible que se cubran distinciones detalladas en las guías de instalación).*
</detalles>
<detalles>
<summary>Haga clic para ver el comando utilizado para generar esta lista de scripts</summary>
```bash
{ find . -maxdepth 1 -type f \( -name "aura_engine.py" -o -name "get_suggestions.py" \) ; find . -path "./.venv" -prune -o -path "./.env" -prune -o -path "./backup" -prune -o -path "./LanguageTool-6.6" -prune -o -type f \( -name "*.bat" -o -name "*.ahk" -o -name "*.ps1" \) -print | grep -vE "make.bat|notification_watcher.ahk"; }
Una descripción gráfica de la arquitectura:¶
Modelos usados:¶
Recomendación: utilice modelos de Mirror https://github.com/sl5net/SL5-aura-service/releases/tag/v0.2.0.1 (probablemente más rápido)
Estos modelos comprimidos deben guardarse en la carpeta modelos/
mv vosk-model-*.zip modelos/
Modelo |
Tamaño |
Tasa de error de palabra/Velocidad |
Notas |
Licencia |
|---|---|---|---|---|
1,8G |
5.69 (prueba de limpieza de librispeech) |
Modelo genérico preciso en inglés de EE. UU. |
Apache 2.0 |
|
1,9G |
9,83 (prueba Tuda-de) |
Gran modelo alemán para telefonía y servidor |
Apache 2.0 |
Esta tabla proporciona una descripción general de los diferentes modelos de Vosk, incluido su tamaño, velocidad o tasa de error de palabras, notas e información de licencia.
Modelos Vosk: XMLDLINK46X
Herramienta de idioma:
(6.6) XMLDLINK47X
Licencia de LanguageTool: GNU Lesser General Public License (LGPL) v2.1 or later
Apoye el proyecto¶
Si encuentra útil esta herramienta, ¡considere invitarnos a un café! Su apoyo ayuda a impulsar mejoras futuras.
