Speech-to-text CLI. 100% local. Built for developers.
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
- Install with
uv tool install hnsand then runhnsin your terminal. - 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". - Press
Enterwhen you're done. The transcribed text will be printed to your terminal and copied directly to your clipboard, ready to be pasted anywhere withCtrl+VorCmd+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
- Configurable: Choose models and languages via environment variables
- Open Source - MIT licensed, fully transparent
Docs
- Overview
- Get Started
- Quick Start: Get
hnsup and running in less than 30 seconds. - Installation: Different ways to install
hns, configure it, and upgrade to the latest version. - Configuration: Configure
hnsto match your hardware and transcription needs. Set up Whisper models and language preferences for optimal performance. - CLI Reference: Detailed reference for all available command-line options for
hns.
- Quick Start: Get
- Use Cases
- Overview: Unlock powerful workflows by integrating
hnswith various CLI tools. - Drive AI Coding Agents With Your Voice: Provide detailed, context-rich prompts to coding agents like Claude Code, Codex CLI, and Cursor CLI with your voice for faster development cycles.
- Turn Your Voice Into Polished Text: Integrate
hnswith LLMs to transforms your raw dictation into polished text for emails, Slack messages, and documents, streamlining your daily communication. - Effortless Daily Journaling With Your Voice: Speak freely in a stream-of-consciousness style and get polished, coherent journal entries or notes by integrating
hnswith LLMs.
- Overview: Unlock powerful workflows by integrating
Usage
Demo
Watch with sound on!
https://github.com/user-attachments/assets/2aa3752e-bd16-4536-81bd-0679c3be3616
1 maintainer
Metadata
1 maintainer
Release files for hns 1.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| hns-1.1.0.tar.gz | 489.4 kB | Without provenance | Details for hns-1.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| hns-1.1.0-py3-none-any.whl | Python 3 | none | any | Details for hns-1.1.0-py3-none-any.whl |
Total release size: 497.2 kB
Release files / hns-1.1.0.tar.gz
| Download URL | hns-1.1.0.tar.gz |
|---|---|
| Size | 489.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
bedd02ecbe0759fc947676a3f4945332920093ed0304237f082dced2c8c6b986
|
|
BLAKE2b-256 checksum How to use checksums |
014966dfb6604dcc0b69e35e0528ea96c5bf8831192bf43ff052f8d6b2e7ee42
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.30 {"installer":{"name":"uv","version":"0.11.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / hns-1.1.0-py3-none-any.whl
| Download URL | hns-1.1.0-py3-none-any.whl |
|---|---|
| Size | 7.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
67c0337694c4867bf30bfb98447054667bb46679093d05f87d395f0c883da606
|
|
BLAKE2b-256 checksum How to use checksums |
5736717d04923e4bdf2d7f885b5ff8eaa4ac312f590e6a410a55fce216fab075
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.30 {"installer":{"name":"uv","version":"0.11.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for hns 1.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
