Be in the meeting. The minutes write themselves — and never leave your machine.
Kitokey records a conversation, transcribes it and writes its minutes on Linux, Windows and macOS — four steps, each usable alone and with the provider you choose, on your machine by default — for people who want to keep control of their data and of their costs.
Installing or updating the foundation this project is built on:
.nstack/handbook/INSTALL.md. Delete this line when it no longer serves.
flowchart LR
U["You<br/>Linux, Windows, macOS"]:::user --> C["Capture"]:::step --> T["Transcribe"]:::step --> R["Summarise"]:::step --> E["Export"]:::step
T -. "only if you chose it" .-> P["A service<br/>with your own key"]:::out
R -. "only if you chose it" .-> P
classDef user fill:#1e3a8a,color:#fff
classDef step fill:#065f46,color:#fff
classDef out fill:#7c2d12,color:#fff
Legend — blue: you, on your own machine · green: Kitokey's four steps, each usable alone · red: what is outside your machine, reached only when you choose it.
No bot joins your meeting and no account is asked for. You tell the other participants that you are recording: Kitokey shows them nothing.
On Fedora and Ubuntu, from a package built from this repository — none is published yet:
nstack release # Fedora: every program, then the rpm
sudo dnf install ./dist/install/kitokey-*.x86_64.rpm
KITOKEY_TARGET=ubuntu-24.04 nstack release # Ubuntu: built in its container, then the .deb
sudo apt install ./dist/install/kitokey_*_amd64.debNeeds podman (modules/install). Fedora's package from Copr, with dnf and the system's
updates, is cycle 07's, and nothing is published
yet. On macOS, GitHub's runner makes the app on every change to a program on main, signed ad hoc, not by Apple.
On Windows, it makes a zip and an MSIX package for the Microsoft Store, not submitted yet. Each waits on a
colleague's trial, in the cycles after it. What a build holds and what leaves your
machine: docs/privacy.md.
| What runs | Its page |
|---|---|
| Kitokey, started with your session: a small window to record, and a call in another application offered to be recorded; the window lists your meetings and what they weigh, names each meeting by its minutes' title, shows one's minutes beside its transcript, its actions as rows and a copy in one click, plays it with its words following, frees space to the system's trash, from where it comes back, and holds the settings — each step's model, fetched on your word | modules/shell |
A recording, from a terminal: kitokey-capture record <folder> |
modules/capture |
The transcript of a session, on the machine: kitokey-transcription <session> --model <file> |
modules/transcription |
The minutes of a transcript, from the provider you chose: kitokey-summary <session> --provider <address> --model <name> |
modules/summary |
Each source is kept as your system delivers it, at its own rate and channels, in 24 bits — about 2 GB an hour on a laptop (ADR-0004). Known: the engine on the machine still writes a few words where nobody speaks, and on a lively meeting misses or mishears about one word in four.
CONTRIBUTING.md — how a change is proposed, verified and merged here.
GPL-3.0 (LICENSE). Built from source, Kitokey is free on every system; the
signed builds for macOS and Windows are what is sold (PDR-0001).
| What | Where |
|---|---|
| Who it is for, and when it is finished | docs/project/ — the charter and the cycles |
| What the product must do, and why | docs/pdr/ |
| How it is built, and why | docs/adr/ |
| Its modules, and the contracts between them | modules/ |