Skip to content
kvm404Public

About

An Omarchy voice assistant. Talk to it, and it opens apps, plays music, messages friends and runs coding agents in herdr.

Topics

Resources

Contributing

Stars

7 stars

Watchers

0 watching

Forks

Repository files navigation

Auren

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

Auren opening apps, playing music, sending a message, drawing in Excalidraw and starting Codex

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.

Install

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.

Omarchy

Auren is in the AUR:

yay -S auren
auren

The 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.

macOS (preview)

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.sh

It 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.

Using it

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.

Under the hood

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.

Safety and privacy

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.

Contributing

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

About

An Omarchy voice assistant. Talk to it, and it opens apps, plays music, messages friends and runs coding agents in herdr.

Topics

Resources

Contributing

Stars

7 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages