sybl 0.1.2

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 indicator — Qt dock pill at top-center (Windows; bundled with install)
• 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, listening pill).

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 setup                # interactive first-run wizard (TTY)
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

Scriptable helpers: sybl status --json, sybl providers, sybl config get/set, sybl restart, sybl logs --follow. See CLI reference.

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
CLI reference	Categorized commands, --json, wizards, exit codes
Providers	Groq & Deepgram BYOK setup
Configuration	config.toml reference
Overlay indicator	Qt listening pill
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