Skip to content
NapkinStackPublic

About

note taker

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Kitokey

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.

What it is

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
Loading

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.

Install it

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

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

Contribute

CONTRIBUTING.md — how a change is proposed, verified and merged here.

Licence

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

Decisions

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/

About

note taker

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages