whatisgithub

What is speechie?

ronykax/speechie — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 2/5Setup · moderate

In one sentence

A small personal server that transcribes audio files to text using an OpenAI-compatible language model API.

Mindmap

mindmap
  root((repo))
    What it does
      Speech to text
      Runs on home server
      Streams results
    Tech stack
      Python
      Uvicorn
      uv
    Use cases
      Self-hosted transcription
      Custom vocabulary
      Personal audio tools
    Audience
      Developers
      Self-hosters
    Setup
      Needs LLM API key
      Dictionary file
      Env file config

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run your own speech-to-text server on a home server or NAS.

USE CASE 2

Transcribe audio files with custom vocabulary like names or brands.

USE CASE 3

Stream transcription results as they are generated instead of waiting for the full file.

What is it built with?

PythonUvicornuv

How does it compare?

ronykax/speechie0xhassaan/nn-from-scratch3ks/embedoc
Stars00
LanguagePythonPythonPython
Last pushed2023-06-08
MaintenanceDormant
Setup difficultymoderatemoderatehard
Complexity2/54/51/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires an OpenAI compatible LLM API key and endpoint to run.

So what is it?

Speechie is a personal speech-to-text server, written in Python and designed by its author to run on their own home server rather than in the cloud. You send it an audio file and it transcribes the spoken words into text, letting you build simple voice-driven tools without relying on a paid third-party transcription service. The setup involves an OpenAI compatible language model API, meaning any provider that accepts requests in the same format OpenAI uses. You configure an API key, the endpoint URL, and which model to use, with the example in the README showing llama-3.1-8b-instant. You also create a dictionary.txt file listing words you want the system to recognize, one per line, which helps the transcription pick up on proper nouns, names, or unusual vocabulary that a general model might otherwise get wrong. The server itself is started with uvicorn, a Python web server framework commonly used to run this kind of lightweight API, and it listens on a port you can configure. To transcribe audio, you send a POST request to the transcribe endpoint with a .wav file attached as a multipart form upload, and the README includes a working curl command showing exactly how to do this. The server streams the response back without buffering, meaning transcription results start arriving as they are generated rather than making you wait for the entire file to finish processing before you see any text. Dependencies are managed with uv, a fast Python package manager, so installing and running the project involves a small, modern toolchain rather than older, heavier package management tools. Beyond what is described here, the README does not go into detail about transcription accuracy, which audio formats besides .wav are supported, or which model actually performs the speech recognition itself.

Copy-paste prompts

Prompt 1
Help me set up the .env file for speechie with an OpenAI compatible API key and model.
Prompt 2
Show me how to send an audio file to the speechie transcribe endpoint with curl.
Prompt 3
Explain how the dictionary.txt file improves transcription accuracy in speechie.

Frequently asked questions

What is speechie?

A small personal server that transcribes audio files to text using an OpenAI-compatible language model API.

What language is speechie written in?

Mainly Python. The stack also includes Python, Uvicorn, uv.

How hard is speechie to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is speechie for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.