Repository navigation
ALOS v2.0.0 — First Public Release
Fully offline personal AI assistant. No API key. No cloud. No subscription.
What is ALOS?
ALOS is an open-source personal AI platform that runs 100% on your own PC — with a professional desktop GUI, local Ollama LLM inference, voice I/O, ESP32 hardware control, and an extensible Skills + MCP ecosystem.
What's included in v2.0.0
Core AI
- Local LLM inference via Ollama (llama3.2, mistral, codellama, phi, gemma, and more)
- 8 specialized intent handlers — Chat, Schedule, Reminders, Health, Code, Smart Home, Day Planner, System
- Conversation memory with configurable history depth
Professional GUI
- Three-panel PyQt6 desktop interface — sidebar + chat panel + context panel
- Dark professional theme with intent badges on each message
- Command Palette (Ctrl+P) with fuzzy search across all commands
- System tray icon with morning briefing shortcut
Voice I/O
- Speech-to-text via faster-whisper (fully local, no API)
- Text-to-speech via Windows SAPI / pyttsx3
Skills System
- Modular Python skill plugins with
@tooldecorator - Built-in: Filesystem, PC Control, Web Search
- Enable/disable at runtime from the GUI — no restart needed
- Write your own skill in a single Python file
MCP Servers
- Connect to any Model Context Protocol server (stdio or HTTP)
- GUI panel to add, connect, and disconnect servers at runtime
ESP32 Hardware
- Control 4 relay channels from voice or GUI
- ILI9341 TFT display (320×240) with 5-screen LVGL GUI
- XPT2046 touchscreen navigation
- Animated ALOS eyes — visual listening indicator
- WebSocket bridge (port 8765)
Memory & Persistence
- SQLite WAL database — 7 tables: sessions, conversations, tasks, schedule, health_log, memory, preferences
Tests
- 161 passing tests across 6 test files
Quick Start
Windows:
git clone https://github.com/sandy001-kki/ALOS.git
cd ALOS
setup.bat
ollama pull llama3.2:1b
python gui_app.pyLinux / macOS:
git clone https://github.com/sandy001-kki/ALOS.git
cd ALOS
bash setup.sh
ollama pull llama3.2:1b
python gui_app.pyRequirements
- Python 3.10+
- Ollama (https://ollama.ai)
- PyQt6
What's next — v3.0.0
See FUTURE_PLAN.md for the full roadmap:
- Phase 2: Connectors (Gmail, Google Calendar, Slack, Notion), advanced GUI, multi-modal input
- Phase 3: ALOS-LM — a custom 1B→7B language model to replace Ollama entirely
- Phase 4: ALOS Cloud, ALOS Mobile, ALOS Hub (community skills marketplace)
Developer: Sandeep Kumar Bollavaram
License: MIT