Open Source & Privacy-First

Luma

A privacy-first voice assistant that runs locally on your machine. Powered by Groq, Moonshine, and Agno for lightning-fast responses.

Get Started Star on GitHub
🎤

Voice Activated

Always listening for the "Alexa" wake word. Completely hands-free interaction.

🧠

Memory

Persistent memory using SQLite. Remembers your conversations and notes.

🔒

Privacy First

Runs locally. Audio is processed on-device. Your data stays with you.

⚡

Ultra Fast

Optimized for low latency using Groq LPU and Moonshine STT.

🔍

Web Search

Real-time information from DuckDuckGo search integration.

🔌

Extensible

Built with Python. Easy to add new capabilities and tools.

Get Started in Minutes

1

Clone Repo

Download source code

git clone https://github.com/mc095/luma.git
2

Install

Setup dependencies

pip install uv && uv sync
3

Get API Key

Free Groq API Key

console.groq.com/keys
4

Configure

Set Environment

echo GROQ_API_KEY=... > .env
5

Run

Start Assistant

uv run python main.py

⚡ One-Command Install (Windows)

Automated setup script for PowerShell

irm https://mc095.github.io/luma/install.ps1 | iex