SpeechKit

SpeechKit

SpeechKit is a Windows-first speech-to-text framework with a desktop host application. It is designed to be embedded into tools that want local-first dictation, optional cloud providers, and a clean host-managed credential model.

The repository treats frontend/app as first-class source. The embedded internal/frontendassets/dist output is generated from that source and should not be edited manually.

What SpeechKit Is

• a Go framework for speech capture, routing, transcription, and desktop integration
• a Wails-based Windows desktop host that exercises the framework end to end
• a local-first runtime with optional provider integrations such as Hugging Face and self-hosted VPS endpoints

Framework Principles

• provider-agnostic core
• tokenless framework layer
• host-managed credentials and secret storage
• local SQLite default for zero-config usage
• Windows-first release quality for the first public version

Three Ways to Use SpeechKit

As a Go Library

Use the framework in your own Go application without any UI:

go get github.com/kombifyio/SpeechKit/pkg/speechkit

Implement a handful of interfaces (Transcriber, AudioRecorder, Persistence) and the framework handles recording lifecycle, job queuing, and transcription routing. See examples/library/ for a working example.

As a Windows Desktop App

Download the installer from the Releases page:

• SpeechKit-Setup-vX.Y.Z.exe — Windows installer
• SpeechKit-Portable-vX.Y.Z.zip — portable bundle (no install required)

As an Android App

The android/ directory contains a Kotlin-based Android implementation with a custom keyboard (HeliBoard integration) and voice assistant service. Android support is under active development.

Current Feature Set

• push-to-talk dictation with overlay feedback
• local runtime state and history via SQLite
• six STT providers: local whisper.cpp, Hugging Face, OpenAI, Groq, Google, self-hosted VPS
• assist mode with LLM-powered smart commands and TTS response
• voice agent mode with real-time audio-to-audio (Gemini Live)
• settings UI for provider, overlay, hotkey, and storage preferences

Provider Credential Model

The framework core does not embed provider tokens.

For Hugging Face, the current host resolution order is:

1. user token stored from Settings
2. install token seeded by the installer and migrated on first start
3. environment variable fallback via token_env
4. explicit Doppler fallback for internal development only

That keeps the public framework neutral while allowing host apps to choose their own policy.

Prerequisites

• Go 1.25+
• Node.js 22+
• MinGW-w64 for CGo on Windows
• NSIS for the canonical Windows build that emits the installer
• optional: ONNX Runtime DLL for Silero VAD
• optional: whisper.cpp server binary for local STT
• optional: Doppler CLI for internal development flows

Quick Start

git clone https://github.com/kombifyio/SpeechKit.git
cd SpeechKit
powershell -ExecutionPolicy Bypass -File scripts/build.ps1

The canonical Windows build produces:

• dist/windows/SpeechKit/SpeechKit.exe
• dist/windows/SpeechKit-Setup.exe

Runtime Configuration

The staged bundle includes config.toml next to SpeechKit.exe. For custom setups, start from config.example.toml.

[huggingface]
enabled = false
model = "openai/whisper-large-v3"
token_env = "HF_TOKEN"

[store]
backend = "sqlite"
save_audio = true
audio_retention_days = 7

Public OSS users should rely on explicit configuration and environment variables. Internal development may additionally use Doppler, but public artifacts must never depend on private Doppler defaults.

Build and Verification

powershell -ExecutionPolicy Bypass -File scripts/build.ps1

This is the canonical verification path. It runs:

• frontend tests
• frontend lint
• frontend production build
• go vet
• go test ./...
• bundle build
• installer build

Project Structure

pkg/speechkit/          Framework-level orchestration (public API)
cmd/speechkit/          Wails desktop host application
frontend/app/           React/Vite UI sources
internal/audio/         Audio capture (WASAPI)
internal/stt/           STT provider implementations (6 providers)
internal/tts/           TTS provider implementations
internal/ai/            LLM integration via Genkit
internal/assist/        Assist mode pipeline (STT -> LLM -> TTS)
internal/voiceagent/    Voice agent (Gemini Live WebSocket)
internal/vad/           Voice activity detection (Silero ONNX)
internal/config/        Runtime config and secret resolution
internal/router/        Provider routing
internal/store/         Local storage (SQLite / PostgreSQL)
internal/secrets/       Host-side secret storage
internal/frontendassets/ Generated embedded frontend assets
android/                Android app and keyboard integration
examples/               Library usage examples
installer/              NSIS Windows installer
scripts/                Build and release scripts
docs/                   Architecture and contributor docs

OSS Release Hygiene

SpeechKit is prepared in a private upstream and mirrored into a separate release repository. Public publication is allowlist-based.

Start with:

• docs/deployment-standards.md
• docs/oss-release-boundary.md
• docs/oss-release-checklist.md

Contributing

See:

• CONTRIBUTING.md
• CODE_OF_CONDUCT.md
• SECURITY.md
• SUPPORT.md
• CHANGELOG.md

License

Apache-2.0. See LICENSE.