Self-hosted real-time speech-to-text server with streaming ASR, speaker diarization, live translation and OpenAI/Deepgram-compatible APIs.
- Stars
- 147
- Forks
- 13
- Open issues
- 0
- Last commit
- 7 months ago
What is it?
Transcriber is a FastAPI web application that turns YouTube links and uploaded audio or video files into text using OpenAI Whisper. Processing runs locally, so media does not need to be sent to a cloud transcription service, and there is no subscription.
Jobs report progress live over WebSockets. Users can choose between the openai-whisper and faster-whisper engines, use NVIDIA CUDA when available with a CPU fallback, and download finished transcripts as .txt files. A library view pairs media files with their transcripts and supports one-click cleanup of matched pairs.
The project includes a Docker image built in multiple stages that runs as a non-root user, and its setup script attempts to install FFmpeg automatically. The UI is built with Jinja2, Alpine.js and Tailwind CSS, and offers dark and light modes.
Key features
- 01Transcribes YouTube URLs and uploaded .mp3, .mp4, .wav and similar files.
- 02Shows live job progress over WebSockets.
- 03Offers openai-whisper and faster-whisper engines with NVIDIA CUDA support.
- 04Pairs media files with transcripts in a library and supports cleanup.
- 05Ships a multi-stage Docker image that runs as a non-root user.
Use cases
- Transcribing interviews or recordings without uploading them to a third-party service.
- Creating text transcripts of YouTube videos for reading or searching.
- Running a private transcription service on a home server or internal network.
Quick start
- 1
Create and activate a virtual environment (macOS/Linux)
python -m venv .venv - 2
Activate the virtual environment (macOS/Linux)
source .venv/bin/activate - 3
Run the automated installer (installs GPU support and dependencies)
python install.py - 4
Start the application, then open http://localhost:8000
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
Things to know
- Requires Python 3.10 to 3.12 for reliable NVIDIA GPU support; Python 3.13+ may fall back to CPU-only PyTorch.
- An NVIDIA GPU is optional but needed for faster transcription.
- FFmpeg is needed; automatic installation may fail and require manual setup.
Topics
FAQ
- What is transcriber?
- Self-hosted web app that transcribes YouTube videos and local audio/video files with OpenAI Whisper, running on your own machine. Transcriber is a FastAPI web application that turns YouTube links and uploaded audio or video files into text using OpenAI Whisper. Processing runs locally, so media does not need to be sent to a cloud transcription service, and there is no subscription.
- Is transcriber free to use? What license does it have?
- transcriber has no declared license. Its code is public, but without a license you have no explicit permission to reuse it; ask the author before relying on it.
- Is transcriber still maintained?
- No commits for 6+ months. The last commit to transcriber was on Mar 18, 2026.
- What can I use transcriber for?
- Transcribing interviews or recordings without uploading them to a third-party service. Creating text transcripts of YouTube videos for reading or searching. Running a private transcription service on a home server or internal network.
- How do I install transcriber?
- Create and activate a virtual environment (macOS/Linux): python -m venv .venv Activate the virtual environment (macOS/Linux): source .venv/bin/activate Run the automated installer (installs GPU support and dependencies): python install.py Start the application, then open http://localhost:8000: uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
- Where can I get transcriber?
- The source code and installation instructions are on GitHub: https://github.com/BrendownFerreira/transcriber
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
Self-hosted, local-first video knowledge base that indexes your videos with transcription, frame analysis and embeddings, then lets you search scenes in natural language.
End-to-end encrypted, open-source collaborative office suite with real-time editing of documents, sheets, presentations, forms, kanban boards and more.
An AI-assisted novel writing app that helps authors generate outlines, characters, worldbuilding and chapters, self-hosted with FastAPI, React and PostgreSQL.
Self-hosted AI stock monitor for A-shares, Hong Kong and US stocks, with portfolio tracking, price alerts, TradingAgents-based analysis and automated reports.
Linux desktop and Sailfish OS app for note taking, reading and translating with offline speech-to-text, text-to-speech and machine translation.