A voice assistant for Omarchy, and for macOS in preview.
Talk to it, and it opens apps, plays music, messages friends and runs coding agents in herdr.
Install · Using it · Docs · Contributing
Press Super+A and say what you want. A tiny robot on your desktop shows what it's doing and answers out loud. When an app has no command for something, Auren looks at the screen and uses the mouse and keyboard.
Auren runs on Omarchy and, as a preview, on Apple Silicon Macs. On both you need Claude Code or Codex, signed in, and an AssemblyAI API key for speech to text.
Auren is in the AUR:
yay -S auren
aurenThe first auren sets it up for you. It asks which keys start Auren (it adds them to
~/.config/hypr/bindings.lua after a backup), whether to set up the browser tools so Auren can work
in your own logged-in browser, and for your AssemblyAI key. Then it adds the bar plugin, downloads
the voice model, starts Auren and runs auren doctor. Run auren setup again any time.
Updates come with your system updates (yay), or from the bar panel.
Installed Auren before it was a package, with ./install.sh? Run yay -S auren, then
/usr/bin/auren setup once. It moves your install over and keeps your settings, keys and voice model.
To let a coding agent do it, paste this into Claude Code or Codex:
Install Auren from https://github.com/kvm404/Auren on this Omarchy machine.
Follow "For coding agents" in its docs/install.md.
Ask all your questions at the start, then install everything in one go.
The install guide covers optional extras, troubleshooting, removal, and installing from a checkout.
You need an Apple Silicon Mac on macOS 14 or newer, and uv
(brew install uv).
git clone --branch v0.1.6 --depth 1 https://github.com/kvm404/Auren.git auren
cd auren && ./install-macos.shIt installs Auren.app and opens its setup window, which walks through the permissions, the AssemblyAI
key and the brain. Then press Control+Option+A to talk. auren update installs new versions.
Auren on macOS has the details and what doesn't work yet.
| Super+A (Mac: Control+Option+A) | Start talking. Press again to send, or while it works to stop it. |
| Super+Shift+A (Mac: Control+Option+Shift+A) | Start a fresh conversation. |
| Mascot | Click to talk. Drag to move it, scroll to resize it. |
| Bar icon (Mac: menu bar icon) | Change the mascot, voice, brain and vocabulary, and install updates. |
Things to try:
- "Open Obsidian on workspace 2."
- "Play some lofi on Spotify."
- "Draw how login works in Excalidraw."
- "Find the cheapest flight to Goa next Friday." (with the browser tools)
- "Ask Codex to fix the failing tests in my project."
If something doesn't work, run auren doctor.
| Brain | Your signed-in Claude Code on Claude Haiku, with Codex as backup. No extra API key. |
| Ears (speech to text) | AssemblyAI, only while you're talking. |
| Voice (text to speech) | Supertonic, running on your own CPU. |
| Coding agents | herdr (optional) |
| Browser | Open Browser Use (optional) |
Haiku is quick because Auren's tools do the heavy lifting. A simple answer comes back in about two seconds.
Auren asks before anything risky, and always asks before publishing, buying or changing the system, except at Full access (never), which asks about nothing.
These checks catch mistakes, but they are not a sandbox.
Your voice goes to AssemblyAI, and your request goes to Claude or Codex. The voice, your history and logs stay on your machine. Read Safety and Privacy for the details.
Auren is free and open source. Bug reports, ideas and pull requests are welcome. Start with Contributing and the roadmap. Releases are listed in the changelog.
MIT licensed
