Dictate coding tasks hands-free — while walking, driving, or away from a keyboard. Untether transcribes your Telegram voice notes via a Whisper-compatible endpoint and runs them as normal text prompts.
=== "untether config"
```sh
untether config set transports.telegram.voice_transcription true
untether config set transports.telegram.voice_transcription_model "gpt-4o-mini-transcribe"
# local OpenAI-compatible transcription server (optional)
untether config set transports.telegram.voice_transcription_base_url "http://localhost:8000/v1"
untether config set transports.telegram.voice_transcription_api_key "local"
```
=== "toml"
```toml
[transports.telegram]
voice_transcription = true
voice_transcription_model = "gpt-4o-mini-transcribe" # optional
voice_transcription_base_url = "http://localhost:8000/v1" # optional
voice_transcription_api_key = "local" # optional
```
Set OPENAI_API_KEY in your environment (or voice_transcription_api_key in config).
To use a local OpenAI-compatible Whisper server, set voice_transcription_base_url
(and voice_transcription_api_key if the server expects one). This keeps engine
requests on their own base URL without relying on OPENAI_BASE_URL. If your server
requires a specific model name, set voice_transcription_model (for example,
whisper-1).
!!! tip "Hot-reload"
Voice transcription settings (voice_transcription, model, base URL, API key) can be toggled by editing untether.toml — changes take effect immediately without restarting (requires watch_config = true).
When you send a voice note, Untether transcribes it and runs the result as a normal text message. If transcription fails, you’ll get an error message and the run is skipped.
!!! user "You" 🎤 (voice note — 0:12)
!!! untether "Untether" 📝 "Add error handling to the upload function and make sure it retries on timeout"
working · claude · 0s
▸ Read `src/upload.py`
