Flowkey

Flowkey is a Windows desktop assistant that adds local-LLM hotkeys for grammar fixes, prompt rewrites, summaries, explanations, tone changes, chat, ask-in-chat, note capture, and FastFlowLM benchmarks.

Everything runs locally through FastFlowLM. No cloud service, analytics, or telemetry is used by the app.

Current version: 1.5.4

Screenshots

Dashboard config	Benchmark runs

Notes setup

Requirements

• Windows 10/11 x64
• AMD Ryzen AI NPU hardware supported by FastFlowLM
• Python 3.11+ for source/developer installs
• AutoHotkey v2+ for source installs
• FastFlowLM (flm) with a local model such as qwen3.5:4b

AMD NPU And FastFlowLM Setup

Install these first on a new machine:

1. Install the latest AMD Ryzen AI / NPU driver from AMD Support or from your laptop manufacturer's support page.
2. Reboot Windows after the driver install.
3. Confirm the NPU appears in Device Manager under Neural processors or as an AMD Ryzen AI / NPU device.
4. Install FastFlowLM from fastflowlm.com or directly with PowerShell:

Invoke-WebRequest https://github.com/FastFlowLM/FastFlowLM/releases/latest/download/flm-setup.exe -OutFile flm-setup.exe
Start-Process .\flm-setup.exe -Wait

5. Open a new terminal and verify FastFlowLM:

flm --version
flm pull qwen3.5:4b
flm run qwen3.5:4b

Install Flowkey

For source installs from this repository:

.\INSTALL.cmd

For Python/developer installs:

python -m pip install -e ".[dev]"

Launch the app with AutoHotkey v2:

& "C:\Program Files\AutoHotkey\v2\AutoHotkey64.exe" .\scripts\grammarFix.ahk

Hotkeys

Hotkey	Action
Ctrl+Shift+G	Grammar fix on selected text
prompt: + Ctrl+Shift+G	Rewrite rough text into a structured prompt
summarize: + Ctrl+Shift+G	Create a 3-bullet summary
explain: + Ctrl+Shift+G	Explain code, regex, SQL, or technical text
tone: + Ctrl+Shift+G	Rewrite in the selected tone preset
Ctrl+Shift+T	Open chat
Ctrl+Shift+A	Ask in chat with selected text
Ctrl+Alt+N	Capture a note

Project Layout

• scripts/ - Python modules and AutoHotkey v2 app code.
• installer/ - optional installer build scripts.
• setup/defaults/ - default config used on first run.
• tests/ - Python and AutoHotkey regression tests.
• config/grammar_hotkey.config.example.json - example user config.
• assets/screenshots/ - README screenshots.

Runtime data, logs, build output, downloaded vendor binaries, caches, and local editor state are intentionally ignored and should not be committed.

Development Checks

python -m pip install -e ".[dev]"
ruff check scripts tests
pytest tests -q

AutoHotkey tests are run by CI on Windows. Locally, run them with AutoHotkey v2:

& "C:\Program Files\AutoHotkey\v2\AutoHotkey64.exe" /ErrorStdOut tests\test_parse_mode.ahk
& "C:\Program Files\AutoHotkey\v2\AutoHotkey64.exe" /ErrorStdOut tests\test_classify_clipboard.ahk