gitwtfhub

wtf is translategemmamcp?

woheller69/translategemmamcp — explained in plain English

Analysis updated 2026-05-18

3HTMLAudience · developerLicenseSetup · moderate

TL;DR

An MCP server and simple web UI that expose a locally running TranslateGemma AI model as a translation tool, letting AI agents and browsers translate text without a cloud service.

Mindmap

mindmap
  root((TranslateGemmaMCP))
    What it does
      Local translation via MCP
      Simple browser web UI
      Privacy first design
    Tech stack
      Python and FastMCP
      llama.cpp
      HTML web UI
    Use cases
      Give agents a translate tool
      Browser based translation
      Private on device translation
    Audience
      Developers running local AI
      Privacy focused users

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

Why would anyone build with this?

REASON 1

Give an AI agent a translate tool that runs entirely on your own hardware via MCP.

REASON 2

Translate text in a browser using a simple local web UI connected to your TranslateGemma server.

REASON 3

Add private, on-device translation to a chatbot or workflow without sending text to a cloud API.

REASON 4

Run TranslateGemma through llama.cpp and expose it as an OpenAI-compatible translation endpoint.

What's in the stack?

PythonFastMCPllama.cppHTML

How it stacks up

woheller69/translategemmamcphannah-wright/saas-landing-page-templatemechanize-work/gba-eval
Stars333
LanguageHTMLHTMLHTML
Setup difficultymoderateeasymoderate
Complexity1/54/5
Audiencedevelopervibe coderresearcher

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires TranslateGemma already running via llama.cpp exposing an OpenAI-compatible endpoint.

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

Wtf does this do

TranslateGemmaMCP lets you run text translation on your own computer using a local AI model called TranslateGemma, instead of sending text to a cloud translation service. It packages this local model behind a Model Context Protocol server, a standard way for AI tools and agents to call external capabilities, so any MCP-compatible client can ask it to translate text. The project has two parts. A simple web page you open directly in a browser gives you a basic interface for translating text by pointing it at your running TranslateGemma server. The main piece is a Python server that exposes a single translate tool over MCP, which takes the text to translate along with source and target language codes, using standard codes like en or de-DE, and returns the translated result. Because everything runs locally, no text is sent to an outside company, which the README highlights as a privacy benefit. To use it, you first need TranslateGemma itself running through llama.cpp, a tool for running AI models on your own hardware, exposed as an OpenAI-compatible API endpoint. You then install a handful of Python packages and start the MCP server, which listens on a configurable host and port and forwards translation requests to that local model. The server includes automatic retries and rate limiting to keep things stable under repeated use. This project is aimed at developers who already run local AI models and want to plug real translation ability into their own tools, chatbots, or AI agents without relying on an external translation API. It is released under the MIT license.

Yoink these prompts

Prompt 1
Help me install fastmcp, uvicorn, httpx, and starlette and start the TranslateGemmaMCP server.
Prompt 2
Show me how to run TranslateGemma through llama-server and point TranslateGemmaMCP at its API endpoint.
Prompt 3
Explain what parameters the translate tool in TranslateGemmaMCP expects and what it returns.
Prompt 4
Walk me through opening translateGemmaWebUI.html and connecting it to my local llama.cpp endpoint.

Frequently asked questions

wtf is translategemmamcp?

An MCP server and simple web UI that expose a locally running TranslateGemma AI model as a translation tool, letting AI agents and browsers translate text without a cloud service.

What language is translategemmamcp written in?

Mainly HTML. The stack also includes Python, FastMCP, llama.cpp.

What license does translategemmamcp use?

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

How hard is translategemmamcp to set up?

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

Who is translategemmamcp for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.