MrDino-Tz/ana-swahili-assistant

# A.N.A (Ana Neural Assistant) - Hybrid Swahili Personal Assistant 🚀 ### *Msaidizi Binafsi wa Kidijitali Aliyebobea Lugha ya Kiswahili na Kazi za Kila Siku* A.N.A (Ana Neural Assistant) ni mfumo wa msaidizi wa kibinafsi wa hali ya juu (State-of-the-Art) ulioundwa maalum kwa lugha ya Kiswahili safi na sanifu. Mfumo huu una muundo wa kipekee wa **Kihuluti (Hybrid Architecture)** ambao unaweza kufanya kazi **nje ya mtandao (Offline CPU mode)** kupitia Ollama ya ndani, au kupitia **mitandao ya wingu yenye kasi kubwa ya API (Groq/OpenRouter)** ili kuondoa mzigo wote wa CPU (0% CPU) kwenye kompyuta yako na kutoa majibu ya papo hapo. --- ## 🌟 Sifa Kuu (Key Features) 1. **Hybrid AI Core (Muundo wa Kihuluti):** * **Njia ya Wingu (Groq / OpenRouter):** Inatumia ufunguo wako wa Groq/OpenRouter kuendesha model zenye nguvu kubwa kama `Llama 3.3 70B` au `Gemma 2 9B` kwa kasi ya ajabu (0% CPU usage na majibu chini ya sekunde 1). * **Njia ya Ndani (Ollama Offline Fallback):** Inajielekeza yenyewe kutumia Ollama na model ndogo ya CPU-optimized `gemma2-swahili` (2B Q4_K_M) iwapo hauna mtandao au funguo za API. 2. **Sauti ya Kiswahili ya Mwanamke (Female Swahili TTS Voice):** * **ElevenLabs Ultra-Realistic:** Sauti inayofanana kabisa na ya binadamu halisi kwa 100% yenye uwezo mkubwa wa hisia. Inatumia ElevenLabs Multilingual V2 (Inahitaji ufunguo wa ElevenLabs API). * **Google Cloud Neural TTS:** Sauti nzuri sana, yenye hisia, inayotiririka na kusikika kama mwanamke halisi anayeongea Kiswahili sanifu (BURE kabisa na inahitaji mtandao). * **Local spd-say (Offline Variant):** Sauti ya ndani ya Linux iliyowekewa nguvu ya kipekee ya `espeak-ng sw+f3` au SAPI5 (Windows) ili kulazimisha mfumo kuongea kwa sauti ya kike badala ya sauti ya kiume ya roboti. 3. **Dynamic Prompt Engineering & Personas:** * Mfumo unapakia profiles za **JSON** kutoka folda la `personas/` ili kubadilisha tabia na utaalamu wa A.N.A papo hapo. * **Time-Aware Context:** Mfumo unaingiza tarehe na saa sahihi ya ko …