drumsergio/akou repository overview

⁠akou

akou is a desktop app for macOS that records your calls on your own computer, transcribes them on the machine, and answers questions about a call while it is still running. There is no bot in the meeting, no account and no cloud: your own terminal agent (Claude Code, Codex or anything that speaks MCP) can follow and question the call, and the notes land in files you own. The same core runs as a self-hosted transcription server⁠ in Docker.

⁠Features

• Records the microphone and the call audio on separate channels, with no bot in the meeting and no virtual audio driver.
• Shows a live transcript as people speak, and runs an accurate pass with speaker labels on your Mac after the call.
• Keeps a timestamped notepad while the call runs; every note carries the time it was written.
• Answers a question about the call while it runs, with the Claude Code or Codex you already pay for, a local model, or your own API key. With none, Ask becomes a search of the call.
• Lets your agent start, follow, question and annotate a call from the terminal, over a local API or MCP.
• Types what you dictate into any app when you hold a key, and learns a word you fix only if you say yes.
• Fixes names and product terms across calls from one word list you own.
• Hands a finished call to your own vault or repository as Markdown, an event log and the audio, through an export folder, hooks, a signed webhook or the API.
• Runs as a transcription server in Docker, with file jobs, an OpenAI-compatible endpoint, and Wyoming (Home Assistant Assist) and Bazarr's /asr endpoints, each one setting away.

⁠Quick start

brew install --cask geiserx/akou/akou
# or download akou-1.0.0-macos-arm64.dmg from https://github.com/GeiserX/akou/releases and drag akou into Applications
open -a akou

The first window asks what you will use akou for and downloads the speech models (about 3.0 GB). At your first Record, macOS asks for the microphone and system audio; the call then shows up in the sidebar with a live transcript. Needs a Mac with Apple silicon and macOS 14.4 or later. To let Claude Code or Codex follow your calls, install the command line from the akou menu and run akou skill install; see Getting started⁠ and Agents and the command line⁠.

⁠Status

1.0.0 is the first stable release. The 0.x releases were prereleases. The app runs on macOS on Apple silicon only, signed with a Developer ID and notarized since 0.6.1. The Windows and Linux archives are the akou command line alone: they manage models and settings and drive a remote akou, but cannot record. Each release's changelog entry⁠ lists its known limitations.

⁠Documentation

Docs: https://geiserx.github.io/akou/⁠

• Getting started⁠: install, the first open, the models, permissions, your first call
• Configuration⁠: every setting and its default
• Usage⁠: the window, notes, Ask, speakers, workspaces
• Dictation⁠: hold a key, speak, and the words land where the cursor is
• Agents and the command line⁠: the skill, the plugin, the CLI, the API and MCP
• Providers⁠: what answers questions, and what it sees
• Hand-off to your knowledge system⁠: export folder, hooks, webhook, pull
• Server mode⁠: the Docker image, keys, GPUs and presets
• How it works⁠
• Troubleshooting⁠
• Development⁠: build, test, release

⁠License

GPL-3.0-or-later⁠. akou is written from scratch and replaces hark⁠, whose capture design it carries over in full.