Question 1

What does Thuki even mean?

Accepted Answer

Thuki (Thư ký) is Vietnamese for secretary: a personal assistant who handles the details so you can focus on the work. The product is built for quick, throwaway conversations powered by local AI models: ask something, get an answer, move on. No history you didn't ask for, no cloud logging everything you type. Long term, Thuki is being built toward a fully agentic assistant that can actually do work on your behalf (Gmail, Calendar, Slack, and more via MCP integrations). The kind of assistant that handles the task, not just the answer.

Question 2

Which Mac does Thuki run on?

Accepted Answer

Thuki is a macOS-only app, built and tuned for Apple Silicon Macs where the local model runs on the built-in GPU. On first launch macOS asks for two permissions: Accessibility (for the global shortcut that summons Thuki from any app) and Screen Recording (for the /screen command). Grant both once. Check the GitHub releases page for the current supported builds.

Question 3

Does Thuki run the AI model itself?

Accepted Answer

No. Thuki is the interface: the floating window, the global shortcut, context capture, and slash commands. The model runs in Ollama, a separate open-source runtime you install once that runs on your own machine. Thuki sends your prompt to Ollama on localhost and streams the answer back. You pick the model; Ollama runs it.

Question 4

Why not just use Ollama directly?

Accepted Answer

Ollama's own app, and local apps like LM Studio or Jan, are destinations: you switch to a window, paste your context, read the answer, switch back. Thuki inverts that. Double-tap Control and it appears over whatever you are doing, already holding your selected text, then vanishes when you dismiss it. Same local models; the difference is the summon-anywhere workflow around them.

Question 5

Do I need an internet connection?

Accepted Answer

No. After the initial model download, the model runs on your own hardware, so everyday use works offline. Web tools like /search reach the internet when you use them.

Question 6

Which models can I use?

Accepted Answer

Open models like Llama 3, Mistral, Phi-3, Qwen, and Gemma. You choose which one to run; see "Does Thuki run the AI model itself?" below for how the model is set up and managed.

Question 7

Where is my data stored?

Accepted Answer

A single SQLite file on your disk. There is no backend, no server, no log you cannot cat. Delete the file and the data is gone.

Question 8

Is there a subscription or per-query charge?

Accepted Answer

No. Once you download Thuki there is no cloud service billing you. Your GPU does the work.

A note from Logan

Connect your tools

Type with your voice

Notes from any meeting

Automate the routine