Whispefy

Whispefy is a small Linux dictation app for Hyprland. It listens from a hotkey or local HTTP trigger, stops on silence, sends audio to Groq Whisper, cleans the transcript with LangChain, and pastes the final text into the focused window.

1 Install

`uv sync` and set `GROQ_API_KEY` in `.env`.

2 Launch

`uv run whispefy` starts the local server and recorder.

3 Trigger

Bind `POST /toggle` from Hyprland or call the local endpoint.

Flow

Trigger Use a hotkey or `POST /toggle` to start a session.

Record Mic input runs locally until silence ends the capture.

Clean Groq Whisper transcribes, then LangChain refines the text.

Insert The final text is inserted into the focused Wayland window.

Use this as a local desktop tool, not a cloud editor. The app keeps the control loop on your machine and only sends audio/text to Groq.

What You Need

• Linux with Wayland
• Hyprland or another Wayland compositor
• uv
• wl-copy
• wtype
• notify-send

What Happens

Input Hotkey or HTTP starts a session.

Silence The recorder stops when speech drops off.

Output The cleaned text goes straight to the cursor.