hns

---

hns is a speech-to-text CLI tool to transcribe your voice from your microphone directly to clipboard. Integrate hns with Claude Code, Ollama, LLM, and more CLI tools for powerful workflows.

hns transcribes your voice 100% locally using faster-whisper. The whisper model is downloaded automatically on first run and after that, hns can be used completely offline. After transcription, the text is displayed in the terminal (written to stdout) as well as automatically copied to your clipboard, ready to be pasted anywhere with Ctrl+V or Cmd+V.

With hns, you can:

• Drive AI coding agents like Claude Code, Codex CLI, and Cursor CLI with your voice
• Dictate and get polished text for emails, Slack messages, and documents
• Speak freely in a stream-of-consciousness style and get polished, coherent journal entry or note

...and much more! Just integrate hns with your favorite CLI tools.

Quick Start

1. Install with uv tool install hns and then run hns in your terminal.
2. When you see 🎤 Recording..., speak the following sentence clearly into your microphone: "In the beginning the Universe was created. This has made a lot of people very angry and been widely regarded as a bad move".
3. Press Enter when you're done. The transcribed text will be printed to your terminal and copied directly to your clipboard, ready to be pasted anywhere with Ctrl+V or Cmd+V.

Highlights

• Instant Clipboard: Transcribed text is automatically copied to your clipboard for immediate pasting
• Composability (The Unix Way): Transcription is written to stdout and progress/status messages to stderr. Easy to integrate with other CLI tools
• 100% Local & Private: Audio is processed entirely on your local machine. No data leaves your device
• Works Offline: After the initial model download, no internet connection is required
• Multi-Language Support: Transcribe in any language supported by Whisper
• : Choose models and languages via environment variables