# akou

![akou](<https://geiserx.github.io/akou/images/banner.svg>)

[![Release](<https://img.shields.io/github/v/release/GeiserX/akou?include_prereleases&amp;style=flat-square>)](<https://github.com/GeiserX/akou/releases>) [![GitHub Stars](<https://img.shields.io/github/stars/GeiserX/akou?style=flat-square&amp;logo=github>)](<https://github.com/GeiserX/akou/stargazers>) [![Docker Pulls](<https://img.shields.io/docker/pulls/drumsergio/akou?style=flat-square&amp;logo=docker>)](<https://hub.docker.com/r/drumsergio/akou>) [![License: GPL-3.0](<https://img.shields.io/github/license/GeiserX/akou?style=flat-square>)](<https://github.com/GeiserX/akou/blob/main/LICENSE>)

---

**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. Start with [Getting started](<https://geiserx.github.io/akou/getting-started/index.md>), then [Usage](<https://geiserx.github.io/akou/usage/index.md>).

- **[Getting started](<https://geiserx.github.io/akou/getting-started/index.md>)**

  ---

  Install the app, let macOS open it once, download the speech models and record your first call.
- **[Usage](<https://geiserx.github.io/akou/usage/index.md>)**

  ---

  The window: Record, the live transcript, notes with times, Ask, speakers and workspaces.
- **[Agents and the command line](<https://geiserx.github.io/akou/agents/index.md>)**

  ---

  Teach Claude Code or Codex to start, follow and question a call, from the terminal or over MCP.
- **[Configuration](<https://geiserx.github.io/akou/configuration/index.md>)**

  ---

  Every setting, its default and what it changes.

## The app

akou is one window: calls on the left, the transcript in the middle, notes and Ask on the right. A saved call shows who spoke and for how long, the transcript with a time on every line, and your notes beside it. See [Usage](<https://geiserx.github.io/akou/usage/index.md>).

![A saved call in akou: the sidebar lists calls by workspace, the header shows three speakers with their talk time, the transcript has a time and a name on every line, and the notes taken during the call sit on the right](<https://geiserx.github.io/akou/images/screenshots/calls.png>)

![A call being recorded: the elapsed time, the microphone and call meters, Stop, the live transcript, and a note being typed](<https://geiserx.github.io/akou/images/screenshots/recording.png>)

During a call

![An answer to a question about the call, citing the time of the line it rests on, with the excerpts it was given](<https://geiserx.github.io/akou/images/screenshots/ask.png>)

Ask about the call

![The first run: the speech models step of the setup, listing the recognizer and the speaker models with their sizes and a download in progress](<https://geiserx.github.io/akou/images/screenshots/first-run.png>)

First run

![A terminal running akou: the live call attached, its last lines with their times, a speaker named, and a question answered](<https://geiserx.github.io/akou/images/screenshots/agent-terminal.png>)

Your agent on the call

Hold a key and speak, and akou types the words where your cursor is, in any app. See [Dictation](<https://geiserx.github.io/akou/dictation/index.md>).

![The Dictation page: the key to hold and how it works, the keys while listening, the languages and the microphone](<https://geiserx.github.io/akou/images/screenshots/dictation.png>)

## What it does

- Records the microphone and the call audio on separate channels, with no bot in the meeting and no virtual audio driver. Call audio is the whole computer or one app.
- Shows a live transcript as people speak. After the call, an accurate pass with speaker labels runs on the Mac, and every line keeps its time of day.
- Keeps a timestamped notepad while the call runs (`-` bullet, `[]` action, `?` question, `#` section).
- Answers a question about the call while it runs, from a small context built locally, with the Claude Code or Codex you already pay for, a local model, or your own API key. With no provider, Ask becomes "Search this call". See [Providers](<https://geiserx.github.io/akou/providers/index.md>).
- Lets your agent start, follow, question and annotate a call from the terminal, the local API or MCP. See [Agents and the command line](<https://geiserx.github.io/akou/agents/index.md>).
- Types what you dictate into any app, and learns a word you fix only when you say yes. See [Dictation](<https://geiserx.github.io/akou/dictation/index.md>).
- Keeps one word list you own, so names and product terms come out right across calls.
- Hands every finished call to your own vault, repository or wiki as Markdown with frontmatter, the event log and the audio, through an export folder, hooks, a signed webhook or the API. See [Hand-off to your knowledge system](<https://geiserx.github.io/akou/knowledge-handoff/index.md>).
- Runs the same core as a self-hosted 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. See [Server mode](<https://geiserx.github.io/akou/server/index.md>) and [GPUs and presets](<https://geiserx.github.io/akou/server-hardware/index.md>).

## How it runs

```
flowchart LR
    MIC[Microphone] --> CAP[Capture helper<br/>two channels]
    CALL[Call audio] --> CAP
    CAP --> ASR[Speech models on this Mac<br/>live pass, then final pass]
    ASR --> LOG[(Event log<br/>one folder per call)]
    LOG --> WIN[The window]
    LOG --> API[Local API<br/>CLI, MCP, skills]
    WIN --> ASK[Ask]
    API --> ASK
    ASK -.-> PROV[Your provider<br/>Claude Code, Codex, a local model, an API key]
    LOG --> OUT[Export folder, hooks,<br/>signed webhook, pull]
    OUT --> KB[Your vault, repo or wiki]
```

- The app runs on Macs with Apple silicon and macOS 14.4 or later. The `akou` command line also runs on Linux and Windows, where it manages models and settings and drives a remote akou, but cannot record.
- The speech models are one download of about 3.0 to 3.7 GB, by what the Mac runs, into Application Support, each file checked against a pinned SHA-256.
- The final pass runs in its own worker and frees its memory when it ends; a long call does not leave the app large.
- The server image is `drumsergio/akou`, on linux/amd64 and linux/arm64, with `-vulkan` and `-cuda` variants. There is no `latest` tag.
- Every action the window has also exists on the local API, so an agent can do anything you can. See [How it works](<https://geiserx.github.io/akou/how-it-works/index.md>).

## What it does not do

- It does not keep a knowledge base across calls: no search across meetings, no people directory. That belongs to the system you hand calls to.
- It does not join a meeting as a bot, and it never sends anything to a meeting service.
- It has no cloud, no account and no sync between machines.
- The desktop app ships for macOS only today. Dictation is macOS only too.

## Privacy

- The audio, the transcript, the notes and the models stay on your disk. Nothing leaves the Mac unless you turn on one of the options below.
- Ask, enhanced notes and the vocabulary pass send a small excerpt of the call to the provider you chose: your own Claude Code or Codex (your subscription), a local model (stays on your machine), or an API with your key. `none` sends nothing. See [When akou calls the provider](<https://geiserx.github.io/akou/providers/#when-akou-calls-the-provider>).
- The export folder, hooks and the webhook run only where you point them, and the webhook is signed and off until both its URL and secret are set.
- The floating bar shown during a screen share carries no transcript text. The dictation island shows your words only when `dictation.pillPreview` is on.
- Server mode has no TLS of its own and refuses to listen on every address until you say a reverse proxy is in front of it.

## Getting help

- If something is broken, read [Troubleshooting](<https://geiserx.github.io/akou/troubleshooting/index.md>), then open an issue with the details it lists.
- To report a security problem, follow the [security policy](<https://github.com/GeiserX/akou/blob/main/SECURITY.md>) and do not open a public issue.
- The [changelog on GitHub](<https://github.com/GeiserX/akou/blob/main/CHANGELOG.md>) lists what changed between releases, and the known limitations of each one.
- The [FAQ](<https://geiserx.github.io/akou/faq/index.md>) answers the questions people ask first, Granola included.
- To build it, run the tests or send a fix, read [Development](<https://geiserx.github.io/akou/development/index.md>).

## License

akou is released under the [GPL-3.0-or-later](<https://github.com/GeiserX/akou/blob/main/LICENSE>) license. It is written from scratch and replaces [hark](<https://github.com/PhantomYdn/hark>), whose capture design it carries over.
