Home
# KashaJervi AI Assistant
KashaJervi is an advanced Android AI assistant designed to behave like a real human assistant (JARVIS-style). It features full phone control via Accessibility Services, voice interaction in Kinyarwanda and English, and an intelligent AI brain.
## Core Features
1. **Voice Control**: Continuous listening or button-activated speech-to-text.
2. **AI Brain**: Powered by Gemini for intelligent reasoning and conversation.
3. **Kinyarwanda Support**: Native support for Kinyarwanda voice input and output.
4. **Phone Automation**: Open apps, scroll, click, and type automatically using Accessibility Services.
5. **Futuristic UI**: A dark-themed, high-tech dashboard for the user.
## Project Structure
- `/android`: Full Android Studio project (Kotlin).
- `/src`: Web Dashboard for AI simulation and documentation.
## How to Build & Install
1. **Prerequisites**: Install Android Studio.
2. **Import**: Open Android Studio and select "Import Project". Choose the `android` folder from this project.
3. **API Key**: Add your Gemini API key to the `MainActivity.kt` or use a backend proxy.
4. **Build**: Go to `Build > Build Bundle(s) / APK(s) > Build APK(s)`.
5. **Install**: Transfer the generated `.apk` file to your Android phone and install it.
## Permissions Required
After installation, you **MUST** enable these manually for full functionality:
1. **Accessibility Service**: `Settings > Accessibility > KashaJervi Control > ON`.
2. **Microphone**: Allow when the app first asks.
3. **Notification Access**: `Settings > Notifications > Device & app notifications > KashaJervi`.
## Voice Commands (Examples)
- "Fungura WhatsApp" (Open WhatsApp)
- "Mbwira igihe" (Tell me the time)
- "Ohereza message" (Send a message)
- "Search for [topic]" (Search on Google)
---
Developed for AI Studio Build.