Your AI companion that listens, remembers, and helps.
LUMA is a privacy-first voice assistant powered by state-of-the-art AI. It runs locally on your machine, remembers what you tell it, and can search the web for real-time information.
Luma.mp4
| Feature | Description |
|---|---|
| Voice Activated | Say "Alexa" to start talking |
| Memory | Remembers things you tell it |
| Web Search | Real-time DuckDuckGo search |
| Private | Runs locally, your data stays with you |
| Fast | Groq-powered for instant responses |
irm https://mc095.github.io/LUMA/install.ps1 | iex# 1. Clone the repository
git clone https://github.com/mc095/LUMA.git
cd LUMA
# 2. Install dependencies
pip install uv
uv sync
# 3. Get your Groq API key from console.groq.com/keys
# 4. Create .env file
echo "GROQ_API_KEY=your_key_here" > .env
# 5. Run LUMA
uv run python main.pyOnce running, simply say "Alexa" to activate, then speak naturally:
LUMA/
├── main.py # Entry point
├── pyproject.toml # Dependencies
├── luma/
│ ├── config.py # Settings & prompts
│ ├── setup.py # First-run setup
│ ├── core/ # Agent, memory
│ ├── db/ # SQLite database
│ └── voice/ # Audio, transcriber, TTS
└── tests/ # Unit tests
- AI: Groq (llama-3.3-70b)
- Agent: Agno
- Speech: Moonshine
- Wake Word: OpenWakeWord
- TTS: Edge TTS
- Search: DuckDuckGo
- Python 3.11+
- Microphone & Speakers
- Groq API key (free)