whatisgithub

What is stt?

jianchang512/stt — explained in plain English

Analysis updated 2026-06-26

4,529PythonAudience · generalComplexity · 2/5Setup · moderate

In one sentence

An offline tool that converts audio or video files into text using AI speech recognition models, with no internet required. Outputs plain text, JSON, or SRT subtitle files with timestamps.

Mindmap

mindmap
  root((repo))
    What it does
      Audio to text
      Video to text
      Subtitle export
    Tech Stack
      fast-whisper models
      Flask web server
      ffmpeg audio
    Use Cases
      Offline transcription
      Caption generation
      API replacement
    Audience
      Content creators
      Developers
      Privacy users
Click or tap to explore — scroll the page freely

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

Transcribe a video interview to text for editing or accessibility without sending data to the cloud.

USE CASE 2

Generate SRT subtitle files from any video by running it through the local server.

USE CASE 3

Replace OpenAI's speech-to-text API in existing software by pointing it at this local endpoint.

USE CASE 4

Process audio files in over a dozen languages with no internet connection required.

What is it built with?

Pythonfast-whisperFlaskffmpegLayui

How does it compare?

jianchang512/sttazure/azure-clitianxiaomo/pytorch-yolov4
Stars4,5294,5294,529
LanguagePythonPythonPython
Setup difficultymoderatemoderatehard
Complexity2/53/54/5
Audiencegeneralops devopsresearcher

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires ffmpeg and Python 3.9, 3.11, CUDA drivers optional but speed up processing significantly on NVIDIA GPUs.

License not mentioned in the explanation, check the repository for details.

So what is it?

This is an offline, locally running tool that converts spoken audio or video into text. You give it a video or audio file, choose the language and which AI model to use, and it returns the transcribed text. The output can be saved as a plain text file, a JSON file, or an SRT subtitle file with timestamps, which is the format used for adding captions to videos. The tool is built on top of an open-source speech recognition model called fast-whisper, which comes in several sizes: tiny, base, small, medium, and large-v3. Smaller models run faster and need less computing power, while larger models produce more accurate transcriptions. You download whichever model size fits your hardware and place it in the models folder. The README is primarily in Chinese but the tool itself supports over a dozen languages, including Chinese, English, French, German, Japanese, Korean, Russian, Spanish, and others. If your machine has an NVIDIA graphics card and the CUDA software installed, the tool will use it automatically to speed up processing. There are two ways to run it. Windows users can download a pre-compiled package that starts with a double-click and opens a browser interface for uploading files. Users on Linux, Mac, or Windows who prefer to run from source need Python between versions 3.9 and 3.11, and must also install ffmpeg, a standard tool for working with audio and video files. Beyond the browser interface, the tool also exposes an API endpoint that is compatible with the same format used by OpenAI's speech-to-text service. This means software that was built to call OpenAI's API can be pointed at this local server instead, with no internet connection required. The project acknowledges fast-whisper, Flask, ffmpeg, and the Layui front-end library as its main dependencies.

Copy-paste prompts

Prompt 1
I have a video file and want to generate an SRT subtitle file using jianchang512/stt running locally. Show me the curl command to call the API endpoint.
Prompt 2
Set up jianchang512/stt on Linux with a medium Whisper model and transcribe a 10-minute English interview audio file.
Prompt 3
I have software that calls OpenAI's speech-to-text API. Show me how to redirect it to a locally running stt server without changing the client code.
Prompt 4
Show me how to install ffmpeg and Python 3.10 and then run the stt tool from source on a Mac.

Frequently asked questions

What is stt?

An offline tool that converts audio or video files into text using AI speech recognition models, with no internet required. Outputs plain text, JSON, or SRT subtitle files with timestamps.

What language is stt written in?

Mainly Python. The stack also includes Python, fast-whisper, Flask.

What license does stt use?

License not mentioned in the explanation, check the repository for details.

How hard is stt to set up?

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

Who is stt for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.