W 100% offline, platforma asystentów głosowych dbająca o prywatność.XSPACEbreakX
Określ dokładnie, co robi Twój głos — od jednego słowaXSPACEbreakX
do pełnych skryptów Pythona. Brak chmury. Żadne dane nie opuszczają Twojego komputera.XSPACEbreakX
Działa w terminalu, przeglądarce lub jako usługa w tle — w systemach Linux, macOS i Windows.
👵 Początkujący
🎓 Uczeń
🧑u200d💻 Programista
Tryb OMA: po prostu napisz słowo, Aura zajmie się resztą
Linux (NixOS): nix-shellsetup/shell.nix, a następnie bashsetup/nixos_setup.sh
===> ⚠️ Eksperymentalny — nietestowany przez autorów, opinie mile widziane! XSPACEbreakX
Windows: ✅ W pełni obsługiwane (używa AutoHotkey/PowerShell).
macOS: ✅ W pełni obsługiwany (używa AppleScript).
Linux (X11/Xorg): ✅ W pełni obsługiwane.
Linux (Wayland): ✅ Pełne wsparcie (testowane na KDE Plasma 6 / Wayland).
Linux (wersja krocząca oparta na CachyOS / Arch): ✅ W pełni obsługiwane.
Wymaga mimalloc (sudopacman-Smimalloc) ze względu na kompatybilność z glibc 2.43.
Linux (NixOS): 🧪 Eksperymentalny — konfiguracja opracowana przez społeczność, jeszcze nie przetestowana.
Jeśli spróbujesz, otwórz problem lub PR i opisz swoje ustalenia! XSPACEbreakX
Linux (Manjaro): Nowość/eksperyment: Ogólnosystemowy klawisz skrótu otwiera interfejs przypominający fzf, sterowany klawiaturą, dzięki czemu możesz uruchamiać polecenia Aury z dowolnego miejsca na pulpicie (całkowicie oddzielone od aktywnego okna). Ten program uruchamiający sterowany klawiszami skrótu jest obecnie zaimplementowany i przetestowany w systemie Linux (Manjaro); inne dystrybucje mogą działać, ale wymagają konfiguracji. Zobacz w 👉 docs/Feature_Spotlight/CopyQ_Shortcut_Super_s.md XSPACEbreakX
XSPACEbreakX
SL5 Aura to kompletny asystent głosowy offline zbudowany na bazie Vosk (dla zamiany mowy na tekst) i LanguageTool (dla gramatyki/stylu), wyposażony w opcjonalną funkcję Local LLM (Ollama) Fallback do kreatywnych odpowiedzi i zaawansowanego dopasowywania rozmytego. Przekształca Twój głos w precyzyjne działania i tekst, zaprojektowany z myślą o maksymalnej personalizacji poprzez podłączany system reguł i dynamiczny silnik skryptowy.
XSPACEbreakX
Tłumaczenia: Ten dokument istnieje również w other languages.
Uwaga: Wiele tekstów to wygenerowane maszynowo tłumaczenia oryginalnej dokumentacji w języku angielskim i mają one wyłącznie charakter ogólny. W przypadku rozbieżności lub niejasności, zawsze obowiązuje wersja angielska. Czekamy na pomoc społeczności w ulepszaniu tego tłumaczenia!
Offline i prywatnie: 100% lokalnie. Żadne dane nigdy nie opuszczają Twojej maszyny.
Dynamiczny silnik skryptowy: Wyjdź poza zastępowanie tekstu. Reguły mogą uruchamiać niestandardowe skrypty Pythona (on_match_exec) w celu wykonywania zaawansowanych działań, takich jak wywoływanie interfejsów API (np. przeszukiwanie Wikipedii), interakcja z plikami (np. zarządzanie listą zadań do wykonania) lub generowanie zawartości dynamicznej (np. kontekstowe powitanie e-mail).
Reguły uwzględniające kontekst: Ogranicz reguły do określonych aplikacji. Używając opcji only_in_windows, możesz mieć pewność, że reguła zostanie wyzwolona tylko wtedy, gdy aktywny będzie określony tytuł okna (np. „Terminal”, „Kod VS” lub „Przeglądarka”). Działa to na wielu platformach (Linux, Windows, macOS).
Silnik transformacji o wysokim poziomie kontroli: implementuje oparty na konfiguracji, wysoce konfigurowalny potok przetwarzania. Priorytet reguł, wykrywanie poleceń i transformacje tekstu są określane wyłącznie na podstawie kolejności reguł w Fuzzy Maps, co wymaga konfiguracji, a nie kodowania.
Oszczędne wykorzystanie pamięci RAM: Inteligentnie zarządza pamięcią, wstępnie ładując modele tylko wtedy, gdy dostępna jest wystarczająca ilość wolnej pamięci RAM, zapewniając, że inne aplikacje (takie jak gry komputerowe) zawsze mają priorytet.
Wiele platform: działa na systemach Linux, macOS i Windows.
W pełni zautomatyzowany: Zarządza własnym serwerem LanguageTool (ale możesz także użyć zewnętrznego).
Dynamiczne zarządzanie stanem poprzez Trino: Silnik konfiguracyjny obsługujący interfejs
oddziela ustawienia dla „mowy”, „terminalu” i „sieci” — zmień je bez
wpływając na innych. Zawiera panel administracyjny działający w czasie rzeczywistym (port 8084).
<szczegóły>
🔌 Gotowe do użycia integracje
XSPACEbreakX
## 🔌 Gotowe do użycia integracje
SL5-Aura zawiera rozległy ekosystem ponad 100+ wstępnie skonfigurowanych wtyczek. Oto kilka najważniejszych wydarzeń:
SL5-Aura zapewnia pierwszorzędną obsługę głosową dla OculiX i SikuliX IDE. Dzięki tej integracji możesz „mówić” swoim kodem automatyzacji.
Voice-to-Snippet: Powiedz „kliknij”, „czekaj” lub „znajdź wszystko”, a usługa natychmiast wpisze poprawny kod Pythona (np. click("image.png")) do IDE.
Window-Aware: Wtyczka jest zależna od kontekstu; aktywuje się tylko wtedy, gdy okno OculiX/SikuliX jest aktywne.
** Inteligentna obsługa języka angielskiego:** zoptymalizowana dla „en-US”, ze szczególnym naciskiem na obce akcenty (np. fonetyka niemiecko-angielska), zapewniająca wysoką dokładność rozpoznawania dla społeczności globalnej.
Rozszerzalny: Wykorzystuje łatwy do edycji format FUZZY_MAP_pre.py.
Stan: Uznawany za wtyczkę społecznościową przez zespół OculiX (zobacz Issue #204).
Aby uzyskać pełne informacje techniczne, w tym wszystkie moduły i skrypty, odwiedź naszą oficjalną stronę dokumentacji. Jest generowany automatycznie i zawsze aktualny.
Pobierz najnowszą wersję lub wersję master (https://github.com/sl5net/SL5-aura-service/archive/master.zip) lub sklonuj to repozytorium na swój komputer.
Uruchom jednorazowy skrypt instalacyjny dla swojego systemu operacyjnego.
Skrypty instalacyjne obsługują wszystko: zależności systemowe, środowisko Python i pobieranie niezbędnych modeli i narzędzi (~4 GB) bezpośrednio z naszych wydań GitHub w celu uzyskania maksymalnej szybkości.
Dla systemów Linux, macOS i Windows (z opcjonalnym wykluczeniem języka)¶
Aby zaoszczędzić miejsce na dysku i przepustowość, możesz podczas instalacji wykluczyć określone modele językowe („de”, „en”) lub wszystkie opcjonalne modele („all”). Podstawowe komponenty (LanguageTool, lid.176) są zawsze uwzględnione.
Otwórz terminal w katalogu głównym projektu i uruchom skrypt dla swojego systemu:
Jeśli nie chcesz instalować narzędzi klienckich (AHK/CopyQ) lub chcesz zaoszczędzić miejsce na dysku, wykluczając określone języki, możesz uruchomić podstawowy skrypt za pomocą wiersza poleceń:
Kliknij dowolne pole tekstowe, naciśnij klawisz skrótu, a pojawi się powiadomienie „Słucham…”. Mów wyraźnie, a potem pauzuj. Poprawiony tekst zostanie wpisany za Ciebie.
Modułowość systemu pozwala na solidną rozbudowę poprzez katalog plugins/.
Silnik przetwarzający ściśle przestrzega hierarchicznego łańcucha priorytetów:
Kolejność ładowania modułów (wysoki priorytet): Reguły załadowane z podstawowych pakietów językowych (de-DE, en-US) mają pierwszeństwo przed regułami załadowanymi z katalogu plugins/ (które ładują się jako ostatnie w kolejności alfabetycznej).
XSPACEbreakX
Kolejność w pliku (mikropriorytet): W dowolnym pliku mapy (FUZZY_MAP_pre.py) reguły są przetwarzane ściśle według numeru wiersza (od góry do dołu).
XSPACEbreakX
Architektura ta zapewnia ochronę podstawowych reguł systemowych, podczas gdy reguły specyficzne dla projektu lub kontekstowe (takie jak te dla CodeIgniter lub kontroli gier) można łatwo dodać jako rozszerzenia o niskim priorytecie za pośrednictwem wtyczek.
<szczegóły>
Kluczowe skrypty dla użytkowników systemu Windows
Kluczowe skrypty dla użytkowników systemu Windows¶
Oto lista najważniejszych skryptów do konfigurowania, aktualizowania i uruchamiania aplikacji w systemie Windows.
Nasz główny silnik do rozpoznawania mowy w trybie offline i przetwarzania dźwięku.
XSPACEbreakX
<szczegóły>
Rdzeń Aury
Aura-Rdzeń/ 🐧 🍏 🪟XSPACEbreakX
├─ aura_engine.py (Główna usługa Pythona zarządzająca Aurą) 🐧 🍏 🪟XSPACEbreakX
├┬ Przeładuj na żywo (konfiguracja i mapy) 🐧 🍏 🪟XSPACEbreakX
│├ Bezpieczne ładowanie prywatnej mapy (na pierwszym miejscu jest integralność) 🔒 🐧 🍏 🪟XSPACEbreakX
││ * Przebieg pracy: Ładuje archiwa ZIP chronione hasłem. XSPACEbreakX
│├ Przetwarzanie i korekta tekstu/ Pogrupowane według języka (np. de-DE, en-US, … ) XSPACEbreakX
│├ 1. normalize_punstanding.py (Standaryzuje interpunkcję po transkrypcji) 🐧 🍏 🪟XSPACEbreakX
│├ 2. Inteligentna korekta wstępna (FuzzyMapPre - The Primary Command Layer) 🐧 🍏 🪟XSPACEbreakX
││ * Dynamiczne wykonywanie skryptów: Reguły mogą uruchamiać niestandardowe skrypty Pythona (on_match_exec) w celu wykonywania zaawansowanych działań, takich jak wywołania API, operacje we/wy plików lub generowanie odpowiedzi dynamicznych.XSPACEbreakX
││ * Wykonanie kaskadowe: Reguły są przetwarzane sekwencyjnie, a ich efekty są kumulatywne. Późniejsze reguły mają zastosowanie do tekstu zmodyfikowanego przez wcześniejsze reguły.XSPACEbreakX
││ * Kryterium zatrzymania o najwyższym priorytecie: Jeśli reguła osiągnie Pełne dopasowanie (^…$), cały potok przetwarzania dla tego tokena zostanie natychmiast zatrzymany. Mechanizm ten ma kluczowe znaczenie dla realizacji niezawodnych poleceń głosowych.XSPACEbreakX
│├ 3. correct_text_by_languagetool.py (integruje narzędzie LanguageTool do poprawiania gramatyki/stylu) 🐧 🍏 🪟XSPACEbreakX
│├ 4. Hierarchiczny silnik reguł RegEx z rezerwą Ollama AI 🐧 🍏 🪟XSPACEbreakX
││ * Kontrola deterministyczna: wykorzystuje silnik RegEx-Rule-Engine do precyzyjnego sterowania poleceniami i tekstem o wysokim priorytecie.XSPACEbreakX
│├ Wtyczka Vector-Search (Leniwe ładowanie): umożliwia wyszukiwanie semantyczne poprzez połączenie lokalnego osadzania wektorów z warstwą rezerwową Ollama/LLM 🐧XSPACEbreakX
││ * Awaryjny algorytm Ollama AI (lokalny LLM): służy jako opcjonalna kontrola o niskim priorytecie w przypadku kreatywnych odpowiedzi, pytań i odpowiedzi oraz zaawansowanego dopasowywania rozmytego, gdy nie jest spełniona żadna reguła deterministyczna.XSPACEbreakX
││ * Status: Lokalna integracja LLM.
│└ 5. Inteligentna korekta końcowa (FuzzyMap)** – Udoskonalenie po LT** 🐧 🍏 🪟XSPACEbreakX
││ * Stosowane po LanguageTool w celu skorygowania wyników specyficznych dla LT. Działa zgodnie z tą samą ścisłą logiką priorytetów kaskadowych, co warstwa wstępnej korekty.XSPACEbreakX
││ * Dynamiczne wykonywanie skryptów: reguły mogą uruchamiać niestandardowe skrypty w języku Python (on_match_exec) w celu wykonywania zaawansowanych działań, takich jak wywołania API, operacje we/wy plików lub generowanie odpowiedzi dynamicznych.XSPACEbreakX
││ * Fuzzy Fallback:Rozmyta kontrola podobieństwa (kontrolowana przez próg, np. 85%) działa jako warstwa korekcji błędów o najniższym priorytecie. Jest wykonywana tylko wtedy, gdy w całym poprzedzającym uruchomieniu reguły deterministycznej/kaskadowej nie znaleziono dopasowania (bieżąca_rule_matched ma wartość False), optymalizując wydajność poprzez unikanie, jeśli to możliwe, powolnych kontroli rozmytych.XSPACEbreakX
├┬ Zarządzanie modelami/ XSPACEbreakX
│├─ prioritize_model.py (optymalizuje ładowanie/rozładowywanie modelu w oparciu o wykorzystanie) 🐧 🍏 🪟XSPACEbreakX
│└─ setup_initial_model.py (Konfiguruje pierwszą konfigurację modelu) 🐧 🍏 🪟XSPACEbreakX
├─ Adaptacyjny limit czasu VAD 🐧 🍏 🪟XSPACEbreakX
├─ Adaptacyjny klawisz skrótu (Start/Stop) 🐧 🍏 🪟XSPACEbreakX
├─ Natychmiastowe przełączanie języka (eksperymentalnie poprzez wstępne ładowanie modelu) 🐧 🍏 XSPACEbreakX
├─ Orkiestracja przepływu powietrza (automatyzacja przepływu pracy oparta na DAG) 🐧 🍏 🪟
│ Wymaga Dockera · Interfejs użytkownika: http://localhost:8081 🐧 🍏 🪟XSPACEbreakX
├─ Trino State Engine (konfiguracja uwzględniająca interfejs dla mowy/terminalu/sieci) 🐧 🍏 🪟
└─ Wymaga Dockera · Interfejs administratora: http://localhost:8084 🐧 🍏 🪟XSPACEbreakX
Narzędzia systemowe/ XSPACEbreakX
├┬ Zarządzanie serwerem LanguageTool/ XSPACEbreakX
│├─ start_languagetool_server.py (Inicjuje lokalny serwer LanguageTool) 🐧 🍏 🪟XSPACEbreakX
│└─ stop_languagetool_server.py (zamyka serwer LanguageTool) 🐧 🍏
├─ monitor_mic.sh (np. do użytku z zestawem słuchawkowym bez użycia klawiatury i monitora) 🐧 🍏 🪟XSPACEbreakX
Narzędzia do niezawodnej obsługi dużych modeli językowych.XSPACEbreakX
Zarządzanie modelem/ 🐧 🍏 🪟XSPACEbreakX
├─ ** Solidny program do pobierania modeli ** (fragmenty wersji GitHub) 🐧 🍏 🪟XSPACEbreakX
├─ split_and_hash.py (Narzędzie dla właścicieli repozytoriów umożliwiające dzielenie dużych plików i generowanie sum kontrolnych) 🐧 🍏 🪟XSPACEbreakX
└─ download_all_packages.py (Narzędzie dla użytkowników końcowych do pobierania, weryfikowania i ponownego składania plików wieloczęściowych) 🐧 🍏 🪟XSPACEbreakX
<szczegóły>
Pomocnicy w zakresie programowania i wdrażania
Pomocnicy w programowaniu i wdrażaniuXSPACEbreakX¶
Skrypty do konfiguracji środowiska, testowania i wykonywania usług.XSPACEbreakX
Wskazówka: glogg umożliwia używanie wyrażeń regularnych do wyszukiwania interesujących zdarzeń w plikach dziennika. XSPACEbreakX
Podczas instalacji zaznacz pole wyboru, aby powiązać je z plikami dziennika. XSPACEbreakX
https://translate.google.com/translate?hl=en&sl=en&tl=pl&u=https://glogg.bonnefon.org/
XSPACEbreakX
Wskazówka: Po zdefiniowaniu wzorców wyrażeń regularnych uruchom python3Tools/map_tagger.py, aby automatycznie wygenerować możliwe do przeszukiwania przykłady dla narzędzi CLI. Aby uzyskać szczegółowe informacje, zobacz Map Maintenance Tools.
Następnie może kliknij dwukrotnie
log/aura_engine.log
XSPACEbreakX
**Pomocnicy deweloperów/**XSPACEbreakX
├┬ **Zarządzanie środowiskiem wirtualnym/**XSPACEbreakX
│├ scripts/restart_venv_and_run-server.sh (Linux/macOS) 🐧 🍏XSPACEbreakX
│└ scripts/restart_venv_and_run-server.ahk (Windows) 🪟
├┬ **Ogólnosystemowa integracja dyktowania/**XSPACEbreakX
│├ Integracja Vosk-System-Słuchacz 🐧 🍏 🪟XSPACEbreakX
│├ scripts/monitor_mic.sh (monitorowanie mikrofonu specyficzne dla Linuksa) 🐧
│└ scripts/type_watcher.ahk (AutoHotkey nasłuchuje rozpoznanego tekstu i wpisuje go w całym systemie) 🪟XSPACEbreakX
└─ **Automatyka CI/CD/**XSPACEbreakX
└─ Rozszerzone przepływy pracy GitHub (instalacja, testowanie, wdrażanie dokumentów) 🐧 🍏 🪟 *(Działa w akcjach GitHub)*XSPACEbreakX
<szczegóły>
Funkcje eksperymentalne
XSPACEbreakX
### **Nadchodzące/eksperymentalne funkcje**XSPACEbreakX
Funkcje obecnie w fazie opracowywania lub w wersji roboczej.XSPACEbreakX
**Funkcje eksperymentalne/**XSPACEbreakX
├─ ENTER_AFTER_DICTATION_REGEX Przykładowa reguła aktywacji „(ExampleAplicationThatNotExist|Pi, Twoja osobista sztuczna inteligencja)” 🐧XSPACEbreakX
├┬WtyczkiXSPACEbreakX
│╰┬ Lenno na żywo – przeładuj (*) 🐧 🍏 🪟XSPACEbreakX
(Zmiany dotyczące aktywacji/dezaktywacji wtyczki i ich konfiguracji zostaną zastosowane przy następnym uruchomieniu przetwarzania bez ponownego uruchomienia usługi.)XSPACEbreakX
│ ├ polecenia git (sterowanie głosowe przy wysyłaniu poleceń git) 🐧 🍏 🪟XSPACEbreakX
│ ├ wannweil (Mapa lokalizacji Niemcy-Wannweil) 🐧 🍏 🪟XSPACEbreakX
│ ├ Wtyczka pokerowa (wersja robocza) (Sterowanie głosowe w aplikacjach pokerowych) 🐧 🍏 🪟XSPACEbreakX
│ └ Wtyczka 0 A.D. (wersja robocza) (Sterowanie głosowe dla gry 0 A.D.) 🐧 XSPACEbreakX
├─ Wyjście dźwięku podczas rozpoczynania lub kończenia sesji (opis w toku) 🐧 XSPACEbreakX
├─ Mowa dla osób niedowidzących (opis w oczekiwaniu na opis) 🐧 🍏 🪟XSPACEbreakX
└─ Prototyp Androida SL5 Aura (jeszcze nie w pełni offline) 📱XSPACEbreakX
(Uwaga: określone dystrybucje Linuksa, takie jak Arch (ARL) lub Ubuntu (UBT) są oznaczone ogólnym symbolem Linuksa 🐧. Szczegółowe rozróżnienia mogą być omówione w przewodnikach instalacji.)
<szczegóły>
Kliknij, aby zobaczyć polecenie użyte do wygenerowania tej listy skryptów
