ℹ️ This is a machine-translated document. In case of discrepancies, refer to the original document.

⬟ SL5 Aura Logo

⬟ SL5 ﻙﺪﻋﺍﻮﻗ .ﻚﺗﻮﺻ – ﺍﺭﻭﺃ.

Stack Overflow Python Privacy Latency License: MIT

.ﺖﻧﺮﺘﻧﻹﺎﺑ ﻝﺎﺼﺗﻻﺍ ﻥﻭﺩ ٪100 ﺔﺒﺴﻨﺑ ﻞﻤﻌﻳﻭ ﺔﻴﺻﻮﺼﺨﻟﺍ ﻰﻠﻋ ﺰﻛﺮﻳ ﻲﺗﻮﺻ ﺪﻋﺎ
ﺓﺪﺣﺍﻭ ﺔﻤﻠﻛ ﻦﻣ — ﻚﺗﻮﺻ ﻪﻠﻌﻔﺗ ﺎﻣ ﻂﺒﻀﻟﺎﺑ ﺩﺪﺣ
.ﻙﺯﺎﻬﺟ ﺕﺎﻧﺎﻴﺒﻟﺍ ﺭﺩﺎﻐﺗ ﻻ .ﺔﺑﺎﺤﺳ ﻻ .ﺔﻠﻣﺎﻛ ﻥﻮﺜﻳﺎﺑ ﺞﻣﺍﺮﺑ ﻰﻟﺇ
.ﺯﻭﺪﻨﻳﻭﻭ ﺱﺇ ﻭﺃ ﻙﺎﻣﻭ ﺲﻜﻨﻴﻟ ﻰﻠﻋ — ﺔﻴﻔﻠﺧ ﺔﻣﺪﺨﻛ ﻭﺃ ،ﺢﻔﺼﺘﻤﻟﺍ ﻭﺃ ﺔﻴﻓﺮﻄ

ﺭﻮﻄﻣ 💻u200d🧑

ﻢﻠﻌﺘﻤﻟﺍ 🎓

ﻦﻴﺋﺪﺘﺒﻤﻟﺍ 👵

grandma-mode: ﻡﻮﻘﺘﺳﻭ ،ﺓﺪﺣﺍﻭ ﺔﻤﻠﻛ ﺐﺘﻛﺍ ﻂﻘﻓ Aura ﻊﻣ ﻢﻠﻌﺗ

ﻲﻗﺎﺒﻟﺎﺑ

ﺢﻔﺼﺘﻤﻟﺍ ﻡﺪﺨﺘﺴﻣ ﺕﺎﻬﺟﺍﻭ ،ﺔﻴﻓﺮﻄﻟﺍ/ﺔﻴﺗﻮﺼﻟﺍ ﺮﻣﺍﻭﻷﺍ ،Trino + Airflow

Energy Consumption

ﺔﻴﺑﺎﺤﺳ ﺔﺒﺳﻮﺣ ﻥﻭﺪﺑ · (Eco-CI ﻡﺍﺪﺨﺘﺳﺎﺑ ﺕﺎﺳﺎﻘﻣ 🌿 ﺩﺭﺎﺑ ﺙ0.36 / ﺊﻓ

Energy Consumption

ﺔﻴﺑﺎﺤﺳ ﺔﺒﺳﻮﺣ ﻥﻭﺪﺑ · ﺓﺩﺭﺎﺑ ﺔﻴﻧﺎﺛ 0.46 / ﺔﻨﺧﺎﺳ ﺔﻴﻧﺎﺛ 0.07 @ ﺔﻄﻳﺮﺧ

ﻊﻳﺮﺴﻟﺍ ءﺪﺒﻟﺍ

ﺔﻌﻳﺮﺳ ﺔﻳﺍﺪﺑ##

(ﻪﺑ ﻰﺻﻮﻣ) ﺐﻳﻮﻟﺍ ﺖﺒﺜﻣﻭ ﺓﺪﺣﺍﻭ ﺓﺮﻘﻨﺑ ﺖﻴﺒﺜﺘﻟﺍ :ﺃ ﺭﺎﻴﺨﻟﺍ ###

:Windows ﻭ macOS ﻭ Linux ﻲﻣﺎﻈﻨﻟ ﻞﻘﺘﺴﻣ ﺖﺒﺜﻣ ﻭﺃ ﺪﺣﺍﻭ ﺮﻄﺳ ﻦﻣ ﺮﻣﺃ

(Git / ﻥﻭﺭﻮﻄﻤﻟﺍ) ﻱﻭﺪﻴﻟﺍ ﺖﻴﺒﺜﺘﻟﺍ :ﺏ ﺭﺎﻴﺨﻟﺍ ###

  1.                            ﻉﺩﻮﺘﺴﻤﻟﺍ ﺍﺬﻫ ﺥﺎﺴﻨﺘﺳﺍ ﻭﺃ ﻞﻳﺰﻨﺘﺑ ﻢﻗ

  2. :(setup/ ﺪﻠﺠﻤﻟﺍ ﻊﺟﺍﺭ) ﻚﻳﺪﻟ ﻞﻴﻐﺸﺘﻟﺍ ﻡﺎﻈﻨﻟ ﺩﺍﺪﻋﻺﻟ ﻲﺼﻨﻟﺍ ﺞﻣﺎ

    •                          `bash setup/manjaro_arch_setup.sh` :(ﻭﺭﺎﺠﻧﺎﻣ/ﺶﺗﺭﺁ) ﺲﻜﻨﻴﻟ

    •                        `bash setup/ubuntu_setup.sh` :(ﻥﺎﻴﺒﻳﺩ/ﻮﺘﻧﻮﺑﻭﺃ) ﺲﻜﻨﻴﻟ

    •                             `bash setup/suse_setup.sh` :(ﻱﺯﻮﺳ ﻦﺑﻭﺃ) ﺲﻜﻨﻴﻟ

    • Linux (NixOS): nix-shell setup/shell.nix ﻢﺛ bash setup/nixos_setup.sh !ﺕﺎﻘﻴﻠﻌﺘﻟﺎﺑ ﺐﺣﺮﻧ ،ﻦﻴﻔﻟﺆﻤﻟﺍ ﻞﺒﻗ ﻦﻣ ﻩﺭﺎﺒﺘﺧﺍ ﻢﺘﻳ ﻢﻟ — ﻲﺒﻳﺮﺠﺗ ⚠️ <===

    •                              `bash setup/macos_setup.sh` :ﻙﺎﻣ ﻞﻴﻐﺸﺘﻟﺍ ﻡﺎﻈﻧ

    •                                        `setup/windows11_setup_with_ahk_copyq.bat` :ﺯﻭﺪﻨﻳﻭ

  3.                                    `./scripts/restart_venv_and_run-server.sh` :ﺔﻟﺎﻬﻟﺍ ءﺪﺑ

  4. **[full guide →](../docs/GettingStarted.i18n/GettingStarted-arlang.md)** — ﺙﺪﺤﺗﻭ ﻚﺑ ﺹﺎﺨﻟﺍ ﻊﻳﺮﺴﻟﺍ ﻞﻴﻐﺸﺘﻟﺍ ﺡﺎﺘﻔﻣ ﻰﻠﻋ ﻂﻐﺿﺍ

Uninstallation

لإزالة الخدمات الأساسية للشركة SL5 Aura, autostart entries, and virtual environments:

  • ** لينوكس/ماكوس:**

  • ** النوافذ (بولندا)**

  • (قواعدك المعتادة في config/maps/ تُبقي آمنة عن طريق التقصير مالم تُحدّدُ --purge). *

متطلبات النظام والقابلية للمقارنة*

  • Windows: ). Fully supported (uses AutoHotkey/Power Shell).

  • ** الدعم الكامل (استخدامات التفريغ).

  • ** لينوكس (X11/Xorg):** مدعم بالكامل

  • ** Linux (Wayland): ✅ Fully supported (tested on KDE Plasma 6 / Wayland).

  • ** لينوكس (CachyOS / Arch-based rolling release):** مدعم بالكامل Requires mimalloc (sudo pacman -S mimalloc) due to glibc 2.43 compatibility.

  • ** Linux (NixOS):** . Experimental — community-contributed setup, not yet tested. إذا حاولت، يرجى فتح قضية أو العلاقات العامة مع النتائج الخاصة بك!

  • ** لينوكس (مانجارو):** New : A system-wide hotkey opens an fzf-like, keyboard-driven interface so you can run Aura commands from anywhere on the officetop (completely decoupled from the active window). ويجري حالياً تنفيذ هذا القاذف الذي يقوده الهوكي واختباره على لينكس (منجارو)؛ وقد تنجح عمليات التوزيع الأخرى ولكنها تتطلب التجهيز. See in docs/Feature_Spotlight/CopyQ_Shortcut_Super_s.md

SL5 Aura is a complete, offline voice Assistant built on Vosk (for Speech-to-Text) and LanguageTool (for Grammar/Style), featuring an optional Local LLM (Ollama) Fallback for creative responses and advanced fuzzing. يُحوّلُ صوتَكَ إلى إجراءاتِ ونصِ دقيقِ، مُصمّمَ للتكييفِ النهائيِ من خلال نظامِ قاعدةِ قابل للذوبانِ ومحركِ كتابة ديناميِ.

الترجمة: وتوجد هذه الوثيقة أيضا في other languages.

ملاحظة: العديد من النصوص هي ترجمات مجهزة آليا للوثائق الانكليزية الأصلية، وهي مخصصة للتوجيه العام فقط. وفي حالة التناقضات أو الغموض، تسود الصيغة الانكليزية دائما. ونرحب بالمساعدة المقدمة من المجتمع لتحسين هذه الترجمة!

Demo

ﻲﻓﺮﻄﻟﺍ ﺯﺎﻬﺠﻠﻟ ﻲﺤﻴﺿﻮﺗ ﺽﺮﻋ 📺 ###

Terminal Demo

.[Zsh Integration](../docs/linux/zsh-integration.i18n/zsh-integration-arlang.md) ﺮﻈﻧﺍ ،ﺔﻴﻓﺮﻄﻟﺍ ﻲﻓ ﻞﻀﻓﺃ ﺔﺑﺮﺠﺗ ﻰﻠﻋ ﻝﻮﺼﺤﻠﻟ **:ﺔﺤﻴﺼﻧ**

ﺭﻮﺼﻤﻟﺍ ﺱﺭﺪﻟﺍ 🎥 ### SL5 Aura: HowTo crash SL5 Aura?

                                    *([skipvids.com](https://skipvids.com/?v=BZCHonTqwUw) :ﻞﻳﺪﺑ ﻂﺑﺍﺭ)*
ﺔﻴﺴﻴﺋﺮﻟﺍ ﺕﺍﺰﻴﻤﻟﺍ

الملامح الرئيسية

  • Offline “ Private: 100% local. لا توجد أي بيانات تترك آلة الخاص بك.

  • ** المهندس الديناميكي:** اذهب بعيداً عن استبدال النص ويمكن أن تنفِّذ القواعد نصوصاً خاصة بالبيتون (on_match_exec) من أجل القيام بأعمال متطورة مثل الاتصال بالآليات (مثل البحث في ويكبيديا)، والتفاعل مع الملفات (مثل إدارة قائمة إلى أخرى)، أو توليد محتوى دينامي (مثلاً، تحية بريد إلكتروني مدرك للسياق).

  • ** قواعد السلوك:** قيد القواعد على تطبيقات محددة. (بإستعمال (إكسينلينيكودي إكس يمكنك أن تتأكد من القاعدة فقط إذا كان لقب النوافذ محدد (مثلاً، (تيرمنال) أو (في إس كود) أو (بروسر This works cross-platform (Linux, Windows, macOS).

  • ** مهندس الترجمة التحريرية للمراقبين الهاديين** يُنفذ خطاً للتجهيز يقوم على أساس التكوين، ويمكن تكييفه بشكل كبير. وتُحدَّد أولوية القواعد، وكشف القيادة، والتحولات النصية فقط بالترتيب التسلسلي للقواعد في خرائط فوزي، التي تشترط ** التداول، وليس الترميز**.

  • ** استخدام محفوظات RAM:** Intelligently manages memory, preloading models only if enough free RAM is available, ensuring other applications (like your PC games) always have priority.

  • ** المنبر:** يعمل على لينكس، ماكوس، وويندوز.

  • ** يُدير خادومه الخاص بكتاب اللغة (ولكن يمكنك أيضا استخدام حاسوب خارجي).

  • المخبأة الذكية تضمن فوراً “التسجيل” والإخطارات والتجهيز السريع

  • ** إدارة الدولة الديناميكية عن طريق ترينو:** محرك التشكيلات المترابطة فــي بيــضــات منفصلة لـ “ speech “ ، و “ terminal “ ، و “ web “ يصيب الآخرين (ه) تشمل أداة في الوقت الحقيقي** (Admin Dashboard**) (التقرير 8084).

الدمج من أجل الاستخدام

ﻡﺍﺪﺨﺘﺳﻼﻟ ﺓﺰﻫﺎﺟ ﺕﻼﻣﺎﻜﺗ 🔌 ##

:ﺓﺯﺭﺎﺒﻟﺍ ﻁﺎﻘﻨﻟﺍ ﺾﻌﺑ ﻚﻴﻟﺇ .ﺎﻘًﺒﺴﻣ ﺪﻌﻣُ ﻖﺤﻠﻣ +100 ﻦﻣ ﺮﺜﻛﺃ ﻢﻀﻳ ﻊﺳ

OculiX/ SikuliX IDE Voice Control SL5-Aura provides first-class voice support for the OculiX and SikuliX IDE. هذا الإدماجِ يُمكِنُكَ مِنْ أَنْ تَسْمِلَ رمزَ التشغيل الآليِ الخاص بكَ.

  • ** صوت إلى الدم** قل “كلاك” ، “انتظر” ، أو “الكل” ، والخدمة على الفور تصنف الرمز الفيثون الصحيح (مثل ، click("image.png"))

  • ** ويندو - آوار** إن البلوجين مراعي للسياق؛ فهو لا ينشط إلا عندما تركز نافذة أوكوليكس/سيكوليكس.

  • ** الدعم الإنكليزي المذكّر:**، على الوجه الأمثل، لشبكة en-US مع التركيز بوجه خاص على اللهجات غير الأصلية (مثل الهواتف الألمانية والإنكليزية)، بما يكفل دقّة عالية في الاعتراف بالمجتمع العالمي.

  • ** مكثف:** (يستخدم شكل (إكسينلينكود2X

Status: اعترف به فريق أوكوليكس (انظر Issue #204).

ﺲﻴﻓﻭﺃ ﺮﺒﻴﻟ ﺮﻳﻮﻄﺗ ﺔﺌﻴﺑ ﻲﻓ ﻲﺗﻮﺼﻟﺍ ﻢﻜﺤﺘﻟﺍ ###

ﻲﺗﻮﺼﻟﺍ ﻢﻜﺤﺘﻟﺍ ﺩﻼﻴﻤﻟﺍ ﻞﺒﻗ 0 ###

ﻖﻴﺛﻮﺗ

ﻖﺋﺎﺛﻮﻟﺍ ##

🔍 Interactive Search (Algolia)

.ﺔﺛﺪﺤﻣ ﺎﻤًﺋﺍﺩ ﻲﻫﻭ ﺎﻴًﺋﺎﻘﻠﺗ ﺎﻫﺅﺎﺸﻧﺇ ﻢﺘﻳ .ﺎﻨﺑ ﺔﺻﺎﺨﻟﺍ ﺔﻴﻤﺳﺮﻟﺍ ﻖﺋﺎﺛﻮﻟﺍ

🇬🇧 English | 🇸🇦 العربية | 🇩🇪 Deutsch | 🇪🇸 Español | 🇫🇷 Français | 🇮🇳 हिन्दी | 🇯🇵 日本語 | 🇰🇷 한국어 | 🇵🇱 Polski | 🇵🇹 Português | 🇧🇷 Português Brasil | 🇨🇳 简体中文

##أضواءالإنارة

  • Interactive Rule Search & Run - Dual-pane fzf rule search, live context previews, immediate command execution via Enter/Ctrl+R, and editor integration via Ctrl+E. دعمه هوكي عالمي (Super+S) وتعدد البيئات المكرسة للبحث عن طريق أوامر الصوت.

حالة البناء

Linux Manjaro Linux Ubuntu Linux Suse

macOS Windows 11

OculiX Compatible

                            👉 **اقرأ هذا بلغات أخرى:**

🇬🇧 English | 🇸🇦 العربية | 🇩🇪 Deutsch | 🇪🇸 Español | 🇫🇷 Français | 🇮🇳 हिन्दी | 🇯🇵 日本語 | 🇰🇷 한국어 | 🇵🇱 Polski | 🇵🇹 Português | 🇧🇷 Português Brasil | 🇨🇳 简体中文

التثبيت

التركيب

) Quick Installation without moderation (Manjaro/Arch Video)

راقب عملية الإنشاء الكامل لمدة 6 دقائق:

  • ** حمولة:

  • ** البداية الأولى**: 3 دقائق (بما في ذلك السارق الترحيبي)

👉 SL5 Aura Installation Live-Demo on YouTube

والإعداد عملية ذات خطوتين:

  1. تحميل آخر الإصدار أو الماجستير (https://github.com/sl5net/SL5-aura-service/archive/master.zip) أو نسخ هذا المستودع إلى حاسوبك.

  2. اجري السيناريو لمرة واحدة لنظام التشغيل الخاص بك.

The setup scripts handle everything: system dependencies, Python environment, and downloading the necessary models and tools (~4GB) directly from our GitHub Releases for maximum speed.

للينكس، ماكوس، وويندوز (باستبعاد اللغة الاختيارية)

وإنقاذاً لأماكن الأقراص وضمادات النطاق الترددي، يمكنك استبعاد نماذج لغوية محددة (de, en) أو جميع النماذج الاختيارية (all) أثناء الإعداد. ** تُدرج دائما عناصر أساسية (LanguageTool, lid.176). ? ?

أفتح محطة طرفية في الدليل الجذري للمشروع وأدير النص لنظامك:

# 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"

####للنافذة أديري النص الأساسي مع امتيازات المدير

** تركيب أداة للقراءة والركض، مثل CopyQ أو AutoHotkey v2**. وهذا مطلوب لمراقب صياغة النصوص.

ويتم تركيبه آليا بالكامل ويستغرق حوالي 8-10 دقائق** عند استخدام نموذجين على نظام جديد.

  1. (نافيت) إلى ملف (سينلينيكودياكس)

  2. إزدحام مزدوج على windows11_setup_with_ahk_copyq.bat.

      • سيحفز النص تلقائيا على امتيازات مدير البرنامج. *

      • It installs the Core System, Language Models, AutoHotkey v2, and CopyQ.

  3. وحالما يكتمل التركيب ** ستبدأ شركة Aura Dictation** تلقائيا.

** ملاحظة:** أنت لا تحتاج إلى تركيب (بايتون) أو (جيت) قبل ذلك؛ السيناريو يعالج كل شيء

##(أ) المتطورة/التركيب العرفي إذا كنت تفضل عدم تركيب أدوات العملاء (AHK/CopyQ) أو تريد أن تنقذ حيز الأقراص باستبعاد لغات محددة، يمكنك تشغيل السيناريو الأساسي عبر خط القيادة:

# 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"
Usage

Usage

بدء الخدمات

On Linux and macOS السيناريو الوحيد يتعامل مع كل شيء ويبدأ العمل بخدمة الديكتاتورية الرئيسية ومراقب الملفات تلقائياً في الخلفية.

# Run this from the project's root directory
./scripts/restart_venv_and_run-server.sh

على النوافذ

بدء الخدمة هو عملية يدوية ذات خطوتين ***:

  1. ** بدء الخدمة الرئيسية: ** تشغيل start_aura.bat، أو بدء تشغيلها من .venv

إعترف بمرحك

لإثارة الإملاء، تحتاج إلى الهوكي العالمي الذي يخلق ملفاً محدداً نحن نوصي بشدة بأداة “إكس إم دلينك اكس”.

توصيتنا: CopyQ

إنشاء أمر جديد في CopyQ باستخدام اختصار عام.

                                  **أمر لنظام لينكس/ماك**

touch /tmp/sl5_record.trigger

      **أمر لنظام ويندوز عند استخدام [CopyQ](https://github.com/hluk/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()
    );
}

      **أمر لنظام ويندوز عند استخدام [AutoHotkey](https://AutoHotkey.com):**

; trigger-hotkeys.ahk
; AutoHotkey v2 script
#SingleInstance Force ; Ensures only one instance of the script runs

;===================================================================
; Hotkey to trigger Aura
; Press Ctrl + Alt + T to write the trigger file.
;===================================================================
f9::
f10::
f11::
{
    local TriggerFile := "c:\tmp\sl5_record.trigger"
    FileAppend("t", TriggerFile)
    ToolTip("Aura Trigger activated!")
    SetTimer(() => ToolTip(), -1500)
}

ابدأوا بالرقص اضغطي في أي مجال للنص، اضغطي على هوكيك، و “التسجيل”… سيظهر الإخطار. تحدث بوضوح، ثم توقف. النص المصحح سيطبع لك

التوثيق المسبق (اختياري)

? Advanced Configuration (Optional)

يمكنك تكييف سلوك التطبيق عن طريق إنشاء ملف محلي

  1. (نافيت) إلى دليل (سينلينكوداكس)

  2. Create a copy of config/settings_local.py_Example.txt and rename it to config/settings_local.py.

  3. Edit config/settings_local.py ( It overrides any setting from the main config/settings.py file).

هذا ملف (سينلينكود 5اكس) يتم تجاهله من قبل (جيت) عن طريق التقصير، لذا فإن تغييراتك الشخصية لن تُخطّى عن طريق التحديثات.

Plug-in Structure and Logic

وحدة النظام تسمح بالتمديد القوي من خلال البلوجينات/التوجيه

ويلتزم محرك التجهيز تقيدا صارما بسلسلة الأولويات الهرمية **:

  1. ** نظام لوض الوحدات (أولوية عالية):** وللقواعد المحملة من مجموعات اللغات الأساسية (de-DE, en-US) الأسبقية على القواعد المحملة من البلوجين/التوجيه (التي تحمل آخر أبجدية).

  2. ** في نظام الملفات (الأولوية المتوسطة):، في أي ملف من ملفات الخرائط (FUZY MAP pre.py)، يتم تجهيز القواعد بصرامة برقم خطي (الطابق الأول).

ويكفل هذا الهيكل حماية قواعد النظام الأساسي، في حين يمكن بسهولة إضافة القواعد الخاصة بالمشاريع أو التي تراعي السياقات (مثل تلك الخاصة بضوابط المدوّنات أو المباريات) باعتبارها امتدادات ذات أولوية متدنية عن طريق البلوغ.

المواصفات الرئيسية لمستعملي النوافذ

ﺯﻭﺪﻨﻳﻭ ﻲﻣﺪﺨﺘﺴﻤﻟ ﺔﻴﺴﻴﺋﺮﻟﺍ ﺕﺎﺘﺒﻳﺮﻜﺴﻟﺍ ##

.Windows ﻡﺎﻈﻧ ﻰﻠﻋ ﻪﻠﻴﻐﺸﺗﻭ ﻪﺜﻳﺪﺤﺗﻭ ﻖﻴﺒﻄﺘﻟﺍ ﺩﺍﺪﻋﻹ ﺔﻴﺠﻣﺮﺒﻟﺍ ﺹﻮﺼﻨﻟﺍ

إنشاء وتحديث

  • chmod +x update.sh; ./update.sh

  • setup/setup.bat: The main script for the initial one-time setup of the environment.

  • or Run powershell -Command "Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process -Force; .\setup\windows11_setup.ps1"

  • update.bat: تشغيل هذا من ملف المشروع لالتقاط آخر رمز ومعالي**.

تشغيل الطلب

  • start_aura.bat: A primary script to start the dictation service.

Core “ Helper Scripts

  • aura_engine.py: The core Python service (usually started by one of the scripts above).

  • get_suggestions.py: A helper script for specific functionsities.

السمات الرئيسية والقابلية للمقارنة

Legend for OS Compatibility

Legend for OS Compatibility:

  • 🐧 Linux (e.g., Arch, Ubuntu)

  • ♪

  • ** أندرويد** (للسمات الخاصة بالهواتف النقالة)

*المهندسة الأساسية

محركنا الرئيسي للتعرف على الخطابات الخارجية والتجهيز الصوتي
Aura core

** Aura-Core/** 🐧 🍏 🪟
├─ aura_engine.py (Main Python service orchestrating Aura) 🐧 🍏 🪟
├┬ ** حمولة ساخنة** (خرائط المؤتمرات) 🐧 🍏 🪟
│├ ** أمن وضع الخرائط الخاصة (المنطقة الوسطى)** 🔒 🐧 🍏 🪟
││ * ** سير العمل** محفوظات محميه من كلمة السر
│├ ** تجهيز النصوص “ تصحيح/** مجمَّعة باللغة (مثل de-DE, en-US, …)
│├ 1. normalize_punctuation.py (Standardizes punctuation post-transcription) 🐧 🍏 🪟
│├ 2. ** Intelligent Pre-Correction** (FuzzyMap Pre - The Primary Command Layer) 🐧 🍏 🪟
││ * ** تنفيذ القانون الديناميكي: يمكن أن تحفز القواعد نصوصاً خاصة بالبيتون (on_match_exec) للقيام بأعمال متطورة مثل المكالمات الهاتفية، أو الملف الأول/أو، أو توليد استجابات دينامية.
││ * ** التنفيذ:** وتتم معالجة القواعد بالتتابع، وتترتب عليها آثار**. وتنطبق القواعد اللاحقة على النص المعدل بقواعد سابقة.
││ * ** أرفع خط للوقف ذي الأولوية**: إذا حققت قاعدة ماتش ** Full Match** (…$)، فإن خط تجهيز كامل لذلك المقطع يتوقف فورا. وتتسم هذه الآلية بأهمية حاسمة في تنفيذ أوامر الصوت الموثوق بها.
│├ 3. correct_text_by_languagetool.py (Integrates LanguageTool for grammar/style correction) 🐧 🍏 🪟
│├ ** محرك القاعدة التنظيمية الهرمية مع (أولاما آي فالباك) 🐧 🍏 🪟
││ * ** هيئة الرقابة المحددة:** تستخدم مهندس قواعد نظام ريجيك للتحكم الدقيق والأولوية العالية ومراقبة النصوص.
│├ * Vector-Search Plugin** (Lazy loading): Enables Semantic search by connecting local Vector embeddings with the Ollama/LM fallback layer 🐧
││ * Ollama AI (Local LLM) Fallback: ويعمل كتحقق اختياري، منخفض الأولوية، من أجل الحصول على إجابات مشبوهة، وفوري ماتشينغ**، عندما لا يتم الوفاء بأي قاعدة حاسمة.
││ * Status: Local LLM integration. │└ 5. ** Intelligent Post-Correction** (FuzzyMap)- Post-LT Refinement * 🐧 🍏 🪟
││ * Applied after LanguageTool to correct LT-specific outputs. يتبع نفس المنطق الدقيق الذي يكتنف الأولوية كطبقة ما قبل الثورة.
││ * * تنفيذ القانون الديناميكي: يمكن أن تحفز القواعد نصوصاً خاصة بالبيتون (on_match_exec) للقيام بأعمال متطورة مثل المكالمات الهاتفية، أو الملف الأول/أو، أو توليد استجابات دينامية.
││ * ** فوزي فالباك The Fuzzy Similarity check (controlled by a threshold, e.g., 85%) acts as the lowest priority error-correction layer. ولا يُنفذ إلا إذا أخفقت القاعدة المحددة/القاضية بأكملها في العثور على تطابق (القاعدة الحالية المتطابقة زائفة)، مما أدى إلى تحقيق الأداء الأمثل بتفادي إجراء عمليات تفتيش بطيئة الازدحام كلما أمكن ذلك.
├┬ ** إدارة النموذج**
│├─ prioritize_model.py (Optimizes model loading/unloading based on usage) 🐧 🍏 🪟
│└─ setup_initial_model.py (Configures the first-time model setup) 🐧 🍏 🪟
├─ ** Adaptive VAD وقت مستقطع 🐧 🍏 🪟
├─ ** هوتيكي آبي (ستارت/توب)** 🐧 🍏 🪟
├─ ** الترجمة التحريرية للغة ثابتة** 🐧 🍏
├─ ** Orchestration** (التشغيل الآلي لسير العمل على أساس برنامج العمل العالمي) 🐧 🍏 🪟 │ Requires Docker · UI: http://localhost:8081 🐧 🍏 🪟
├─ ** محرك دولة ترينو** (الثقة بين الوجوه لكل خطاب/عصر/ويب) 🐧 🍏 🪟 └─ Requires Docker · Admin UI: http://localhost:8084 🐧 🍏 🪟

** المرافق العامة**
├┬ ** إدارة مكتب خدمات الترجمة التحريرية**
│├─ 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) 🐧 🍏 🪟

** موديل إدارة الأمتعة *

أدوات للتعامل القوي مع نماذج اللغات الكبيرة.

** الإدارة النموذجية** 🐧 🍏 🪟
├─ * حمّل نموذجي للدبابات** 🐧 🍏 🪟
├─ 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) 🐧 🍏 🪟

مساعدو التنمية والنشر

** المساعِدون في مجال التنمية*

Scripts for environment setup, testing, and service execution.

يُمكِنُكِ (غلج) من استخدام تعبيرات منتظمة للبحث عن أحداث مثيرة في ملفات سجلكِ
من فضلك تحقق من صندوق الشيكات عند تركيبه لربطه بملفات السجل
https://glogg.bonnefon.org/

Tip: After defining your regex patterns, run python3 tools/map_tagger.py to automatically generate searchable examples for the CLI tools. انظر Map Maintenance Tools للتفاصيل. *

ثم ربما مزدوجة log/aura_engine.log

** DevHelpers/**
├┬ ** الإدارة البيئية الافتراضية**
│├ scripts/restart_venv_and_run-server.sh (Linux/macOS) 🐧 🍏
│└ scripts/restart_venv_and_run-server.ahk (Windows) 🪟
├┬ ** التكامل على نطاق المنظومة*
│├ نظام الاستماع 🐧 🍏 🪟
│├ scripts/monitor_mic.sh (Linux-specific microphone monitoring) 🐧
│└ scripts/type_watcher.ahk (AutoHotkey listens for recognized text and types it out system-wide) 🪟
└─ CCI/CD Automation/
└─ تدفقات العمل الموسعة (التركيب والاختبار ونشر الوثائق)*

السمات التجريبية

** يَتَغَرُّبُ / المعالم التجريبية

المعالم قيد التطوير حالياً أو التي هي في وضع مشروع.

** الرسوم العرضية/**
├─ ترجمة 🐧
├┬Plugins
│╰┬ Live Lazy-Reload () 🐧 🍏 🪟
() تُطبَّق على عملية التفعيل/التنشيط التي تُنفَّذ في البلوجين، وعلى تشكيلاتها، في مرحلة التجهيز التالية دون إعادة تشغيل الخدمة*.
│ ├ ** أوامر مقدمة* (مراقبة صوتية لإرسال أوامر جيت) 🐧 🍏 🪟
│ ├ wannweil (Map for Location Germany-Wannweil) 🐧 🍏 🪟
│ ├ ** بوكر بلوغين (المشروع)** (التحكم الصوتي في تطبيقات البوكر) 🐧 🍏 🪟
│ └ ** A.D. Plugin (Draft)** (Voice control for 0 A.D. game) 🐧
├─ ** الناتج الصوتي عند بدء أو إنهاء دورة** (لم يبت فيه بعد) 🐧
├─ ** الناتج العلمي للإعفاء الافتراضي** (لم يبت فيه بعد) 🐧 🍏 🪟
└─ SL5 Aura Android Prototype* (Not fully offline yet) 📱

  • (ملاحظة: تغطى التوزيعات المحددة للينكس مثل أرتش (ARL) أو أو أوبونتو (UBT) برمز “ لينكس “ العام. ويمكن أن تشمل أدلة التركيب تمييزا مفصلا*.

إضغطْ لرُؤية القيادةِ كَانتْ تَولدُ هذه القائمةِ النصيةِ 
{ 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"; }
A graphical overview of the structure

A graphical overview of the structure:

yappi_call_graph

pydeps -v -o dependencies.svg scripts/py/func/main.py

النماذج المستعملة

النماذج المستعملة:

Recommendation: use models from Mirror https://github.com/sl5net/SL5-aura-service/releases/tag/v0.2.0.1 (probably faster)

هذه النماذج المزدوجة يجب أن تُنقذ في مجلدات models/

mv vosk-model-*.zip models/

ﺺﻴﺧﺮﺘﻟﺍ

ﺕﺎﻈﺣﻼﻣ

ﺔﻋﺮﺴﻟﺍ/ﺔﻤﻠﻜﻟﺍ ﻲﻓ ﺄﻄﺨﻟﺍ ﻝﺪﻌﻣ

ﻢﺠﺤﻟﺍ

ﺝﺫﻮﻤﻧ

vosk-model-en-us-0.22

1.8 5.69

ﺎﺠﻴﺟ (ﺭﺎﺒﺘﺧﺍ librispeech ﻒﻴﻈﻧ)XHTMLTAG0

vosk-model-de-0.21

1.9 9.83

ﻡﺍﺮﺟ (ﺭﺎﺒﺘﺧﺍ Tuda-de)
24.00 (ﺖ

.ﺺﻴﺧﺮﺘﻟﺍ ﺕﺎﻣﻮﻠﻌﻣﻭ ،ﺕﺎﻈﺣﻼﻤﻟﺍ ،ﺔﻋﺮﺴﻟﺍ ﻭﺃ ﺕﺎﻤﻠﻜﻟﺍ ﺄﻄﺧ ﻝﺪﻌﻣ ،ﺎﻬﻤﺠﺣ ﻚ

  •                                    Vosk:** [Vosk-Model List](https://alphacephei.com/vosk/models) ﺝﺫﺎﻤﻧ**

  • LanguageTool:
    (6.6) https://languagetool.org/download/

                             LanguageTool:** [GNU Lesser General Public License (LGPL) v2.1 or later](https://www.gnu.org/licenses/old-licenses/lgpl-2.1.html) ﺺﻴﺧﺮﺗ**

ﻉﻭﺮﺸﻤﻟﺍ ﻢﻋﺩ ## .ﺔﻴﻠﺒﻘﺘﺴﻤﻟﺍ ﺕﺎﻨﻴﺴﺤﺘﻟﺍ ﻞﻳﻮﻤﺗ ﻲﻓ ﺪﻋﺎﺴﻳ ﻚﻤﻋﺩ !ﺎﻨﻟ ﺓﻮﻬﻗ ءﺍﺮﺷ ﻲﻓ ﺮﻴﻜﻔ

ko-fi

Stripe-Buy Now