🎤 Yappatron

Just yap.

Open-source always-on voice dictation.
No hotkeys. No toggles. Just talk.

Why Yappatron?

Current dictation apps make you push buttons. Hold a key. Toggle on and off. That's not how talking works. Yappatron just listens.

🔊 Always On

No push-to-talk. No toggle. Start talking and your words appear. Stop talking and... nothing happens. It just waits.

⚡ Real-time Streaming

Characters appear as you speak. Like watching yourself think onto the screen.

🔒 Fully Local

All processing happens on your machine. No cloud. No data leaving your computer. Ever.

🎯 Knows Your Voice

Speaker identification means only YOU can dictate. Someone walks up? They can't hijack your input.

🧠 Context Aware

Text input focused? Stream right into it. Nothing focused? Collect in a floating bubble.

📖 Custom Vocabulary

Add your own words, names, acronyms. Yappatron learns how you talk.

How It Works

$ yappatron

Loading Whisper model 'base'...

Model loaded.

==================================================

YAPPATRON - Just yap!

==================================================

Listening... (Ctrl+C to stop)

[Speaking...] Hello world this is me just talking naturally [Done]

Voice Activity Detection — Silero VAD detects when you start speaking
Speaker Verification — Optional check that it's actually you
Streaming Transcription — Whisper transcribes in real-time
Smart Output — Text streams to focused input or floating bubble

Installation

# Clone the repo
git clone https://github.com/alosec/yappatron
cd yappatron

# Install
./scripts/install.sh

# Run
yappatron

Requirements

macOS (Apple Silicon recommended)
Python 3.10+
Microphone permissions
Accessibility permissions (for keystroke simulation)

Usage

# Start dictating (just talk!)
yappatron

# Use a larger model for better accuracy
yappatron --model small

# Enroll your voice for speaker ID
yappatron enroll

# Disable speaker verification
yappatron --no-speaker-id

Custom Vocabulary

Edit ~/.yappatron/vocabulary.yaml:

vocabulary:
  - word: Yappatron
    aliases: ["yap a tron", "yapper tron"]
  - word: API
    aliases: ["a p i"]
  - word: OAuth
    aliases: ["o auth"]

Philosophy

The best interface is no interface.

Voice dictation should be invisible. You think, you speak, words appear. No buttons, no modes, no cognitive overhead.

Yappatron is an experiment in ambient computing — technology that fades into the background and just works.

Contributing

Yappatron is open source and contributions are welcome! Check out the GitHub repo.