badrboudaz-png/jarviss

Local AI Assistant with Darija Arabic support # Jarviss - Local AI Assistant (Darija) A powerful local AI assistant that communicates in **Darija (Moroccan Arabic)** with text and audio support. Jarviss can execute various tasks on your laptop both offline and online. ## Features ✨ **Multi-Language Support**: Darija (Moroccan Arabic) text & audio 🎙️ **Voice I/O**: Speech-to-Text & Text-to-Speech 🤖 **Local AI**: Runs offline with local LLMs (Ollama) ☁️ **Online Mode**: Optional internet connectivity for enhanced features ⚙️ **Task Automation**: - Open applications - File management (read/write/delete) - System control (shutdown, restart, sleep) - Web searches - Information retrieval - Custom scripts execution ## System Requirements - Python 3.8+ - 4GB RAM (minimum for local LLM) - 10GB disk space (for models) - Microphone & Speakers (for audio) - macOS / Linux / Windows ## Quick Start ### 1. Clone Repository ```bash git clone github.com cd jarviss ``` ### 2. Install Dependencies ```bash pip install -r requirements.txt ``` ### 3. Install Ollama Download from: ollama.ai ### 4. Pull Arabic Model ```bash ollama pull mistral ``` ### 5. Run Jarviss ```bash python main.py ``` ## Usage ``` Jarviss> شنو الجوج ديالك (What's the weather?) Jarviss> فتح الفايرفوكس (Open Firefox) Jarviss> شنو الساعة (What time is it?) ``` ## Project Structure ``` jarviss/ ├── main.py # Entry point ├── config.py # Configuration settings ├── requirements.txt # Python dependencies ├── README.md # This file ├── src/ │ ├── __init__.py │ ├── core.py # Main Jarviss logic │ ├── llm.py # LLM integration (Ollama) │ ├── speech.py # Speech-to-Text & Text-to-Speech │ ├── tasks.py # Task execution │ └── utils.py # Utility functions └── models/ # Local models storage ``` ## License MIT License --- **Made with ❤️ for Moroccan developers**