explaingit

saitejamummadi/subagent

Analysis updated 2026-05-18

0TypeScriptAudience · developerComplexity · 4/5LicenseSetup · hard

TLDR

An on prem subtitle translation studio for Telugu, Hindi, Tamil, Malayalam, and Kannada, using a local GPU model so no subtitle text leaves the network.

Mindmap

mindmap
  root((SubAgent))
    What it does
      Imports SRT and RTF
      Localizes subtitle cues
      Exports translated files
    Languages
      Telugu
      Hindi
      Tamil
      Malayalam
      Kannada
    Tech stack
      FastAPI backend
      React frontend
      vLLM inference
    Privacy
      No third party APIs
      Private network only
    Audience
      Localization teams

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

Localize subtitles for a confidential video project without sending text to a third party API

USE CASE 2

Translate SRT subtitle files into Telugu, Hindi, Tamil, Malayalam, or Kannada with model assisted suggestions

USE CASE 3

Run a self hosted subtitle editor inside a private network for NDA covered content

What is it built with?

PythonFastAPIReactTypeScriptvLLM

How does it compare?

saitejamummadi/subagent0xkinno/astraea0xkinno/halcyon
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardhardhard
Complexity4/54/54/5
Audiencedeveloperdeveloperdeveloper

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

How do you get it running?

Difficulty · hard Time to first run · 1h+

Needs Windows, Docker with GPU passthrough, and an NVIDIA GPU for live suggestions.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

SubAgent is a subtitle localization tool meant to run entirely inside a private network, with no data ever sent to an outside company. You import a subtitle file in SRT or RTF format, optionally attach the matching video, and then go through each subtitle line, called a cue, translating it into Telugu, Hindi, Tamil, Malayalam, or Kannada. As you work, a language model running on your own graphics card suggests translations you can accept or edit, and the finished subtitles can then be exported. The project exists because most subtitle translation tools send your dialogue to a third party API, which is a problem if the content is under a non disclosure agreement or if you simply do not want an outside vendor involved. SubAgent keeps the editor, the translation model, and the conversion between romanized and native script text all inside infrastructure you control, with no calls to any hosted AI service anywhere in the code. The editor shows the video on one side and the list of cues on the other, with each cue expandable to show the original text, an editable translation, and suggestion chips with confidence scores from the model. Behind the scenes, a React frontend talks to a FastAPI backend backed by SQLite, which in turn talks to a translation model served through vLLM and a transliteration service, both reachable only over private or local network addresses so that pointing the system at a public server on purpose still fails. Running it requires Windows, Python 3.12, Node 20 or newer, Docker Desktop with GPU support, and an NVIDIA graphics card for live translation suggestions, though the editing and export features work without a GPU using a stand in translation worker. The project includes a one command startup script as well as instructions for starting each piece by hand. It is licensed under MIT.

Copy-paste prompts

Prompt 1
Walk me through setting up SubAgent's backend, frontend, and inference services locally
Prompt 2
Explain how SubAgent guarantees subtitle text never leaves the private network
Prompt 3
Help me configure the vLLM inference service for sarvam-translate on my GPU
Prompt 4
Show me how the cue editor and suggestion chips work in the SubAgent UI

Frequently asked questions

What is subagent?

An on prem subtitle translation studio for Telugu, Hindi, Tamil, Malayalam, and Kannada, using a local GPU model so no subtitle text leaves the network.

What language is subagent written in?

Mainly TypeScript. The stack also includes Python, FastAPI, React.

What license does subagent use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is subagent to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is subagent for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.