sybl 0.1.1

Open-source BYOK voice dictation — speak anywhere, transcribe fast, type it in.

sybl

Open-source, bring-your-own-key voice dictation. Put your cursor anywhere, hit a

global shortcut, speak, and sybl transcribes it fast — then types it in for you.

The open-source alternative to closed dictation tools like Wispr Flow. No subscription,

no sybl-hosted backend: your audio goes straight to the STT provider you choose.

Features

• Wispr-style hotkeys — hold for push-to-talk or double-press for hands-free

  toggle on the same binding (default both mode)

• BYOK STT — Groq Whisper (batch) and Deepgram (streaming) today; pluggable providers

• Background daemon — sybl start returns immediately; sybl tui for logs and settings

• Types where you were focused — clipboard-paste injection on Windows

• Listening pill — small overlay near your cursor while dictating (Windows)

• Sound cues — built-in chime or custom start.wav / stop.wav in your config folder

• Custom vocabulary — STT hints for names and jargon via sybl config vocab

• Voice commands — new line, period, comma in final transcripts

• Local-first — no telemetry; API keys in the OS keyring

Install

pipx install sybl

Or with uv:

uv tool install sybl

Requires Python 3.12+. Windows is the primary supported platform for the full

core loop (hotkeys, injection, indicator).

First install pulls ~45 Python packages (numpy, textual, STT SDKs, etc.) — expect

1–3 minutes on a cold pipx install; upgrades are faster.

Quick start

sybl doctor

sybl config init          # creates config.toml + sounds/ folder

sybl config set-key groq

sybl start                # background daemon

sybl tui                  # optional — logs, history, settings

Hold Ctrl+Alt+Space (~200ms) for push-to-talk, or double-press for toggle.

Press Esc while listening to cancel. Stop the daemon with sybl stop.

See Getting started for the full walkthrough.

Documentation

| Doc | Description |

| --- | --- |

| Getting started | Install, first run, daemon + TUI |

| Providers | Groq & Deepgram BYOK setup |

| Configuration | config.toml reference |

| Permissions | Microphone and injection notes |

| Development | Local dev, phases, integration tests |

| Roadmap | What's built and what's next |

| Daemon architecture | IPC and process model |

Contributing

Contributions welcome! See CONTRIBUTING.md and AGENTS.md

for architecture and conventions.

License

MIT © Rikhil Nellimarla