0.1.0 · private beta · AGPL-3.0

Talk. It understands.

A Linux daemon that turns natural speech into context-aware text, adapted to your terminal, editor, chat, or email. Open-source, fast, and currently application-gated for hosted beta access.

Get started ↵ View on GitHub
Context-aware Hosted or BYO-key Wayland-native path Local debug cache off
LIVE · hold-to-talk
ctx: kitty + nvim
A Talk-to-Tux desktop scene with a Linux penguin and voice workflow interface
~1.4s · end-to-end

Beta access

One route for each state.

Hosted access is application-gated during private beta. Apply from the site, then start approved sign-in from the desktop repo checkout so the app can create its local OAuth callback.

01

New here

Submit the hosted beta form with your GitHub username and Linux setup.

Apply for access
02

Already applied

Watch the email address you submitted. A duplicate GitHub application returns status guidance instead of creating another queue entry.

Check beta guidance
03

Approved

Run sign-in from the desktop app. The website cannot complete this step by itself because the CLI owns PKCE state and the local callback.

uv run talk-to-tux login
Open setup docs

01 · Pipeline

From speech to system intent.

01

Hold trigger

Use a mouse side button or configured keyboard hotkey.

02

Speak

Say what you want naturally. A short ring buffer catches the start.

03

Understand

Active-window context, AT-SPI text, and screenshots can inform the rewrite.

04

Act

Paste the final text in place using the platform-appropriate path.

04 · Install

Use the repo build for beta.

The current beta install path is the repository workflow with uv. Packaged installers will be documented after release packaging is verified.

Read setup details 
git clone https://github.com/viperjuice/talk-to-tux.git
cd talk-to-tux
uv sync --all-groups
uv run talk-to-tux

03 · Local-first

Hosted beta when you want it. BYO-key when you do not.

Hosted

Sign in with GitHub, use quota-managed Supabase Edge Functions, and send audio and rewrite requests through the hosted beta service.

  • GitHub account required
  • Monthly beta quotas
  • Groq-backed hosted STT and rewrite today

BYO-key

Keep provider choices under your own configuration and use your local or third-party STT and rewrite credentials without Talk-to-Tux hosted STT/rewrite.

  • No hosted account required for BYO-key mode
  • Uses configured providers
  • Local debug cache stays off by default

02 · Context engine

It knows what you're doing. Only when you ask.

Beta access is free while the service is being tested. Contribution-based lifetime Pro grants are intended for meaningful project contributions, subject to the self-drafted beta terms and maintainer review.

View beta access routes Read beta terms

Ready route

Try the Linux voice workflow against real apps.

Apply for hosted beta access, or use the README to run the current repository build in BYO-key mode.

Apply for hosted beta Open README