
TypingMind×
MedGemma-TextHow to self-host MedGemma-Text with Hugging Face TGI as private AI
Run MedGemma-Text from Google as your own private, self-hosted AI. TGI runs the model on your own GPU server, and TypingMind gives you a full chat app on top of it. Your prompts stay on your servers, and there is no per-message cost.
About MedGemma-Text: MedGemma is a collection of Gemma 3 variants that are trained for performance on medical text and image comprehension.
MedGemma-Text Overview
| Model | MedGemma-Text |
| Made by | |
| Runs on | Hugging Face TGI |
| Versions | medgemma-27b-text-it |
| Model weights | 54 GB |
| Minimum GPU | 1 × 80 GB GPU |
| License | Health AI Developer Foundations |
| Access | Needs approval on Hugging Face |
| TGI model ID | google/medgemma-27b-text-it |
| Downloads on Hugging Face | 18K last month |
| Model icon | Get the icon for TypingMind |
Which version of MedGemma-Text should you pick?
Each version is a different size of MedGemma-Text. Bigger versions give better answers but need more GPU memory. Pick the biggest one that fits your GPUs.
| Model ID | Parameters | Weights | Suggested GPU |
|---|---|---|---|
google/medgemma-27b-text-itused in this guideneeds approval | 27B | 54 GB | 1 × 80 GB GPU |
Suggested GPU is a rough guide: the full-precision weights plus about 20% and 2 GB for chats. Longer context windows and more users need more. A 24 GB GPU is an NVIDIA L4, A10G, or RTX 4090, and an 80 GB GPU is an A100 or H100.
Run MedGemma-Text with TGI
The steps below use google/medgemma-27b-text-it.
Before you start
- You need a Linux server with an NVIDIA GPU, Docker, and the NVIDIA Container Toolkit. A cloud GPU server works too. TGI doesn't run on a Mac; on a laptop, use Ollama or LM Studio.
- Hugging Face has archived TGI. It still works, but it no longer gets updates, and new model families go to vLLM and SGLang instead.
Get MedGemma-Text from Hugging Face
Open google/medgemma-27b-text-it on Hugging Face. The model ID is the part after huggingface.co/, and you can copy it with the button next to the name. The text-generation-inference tag means the model works with TGI.

MedGemma-Text needs access approval. Log in to Hugging Face, open the model page, and accept the license terms (Health AI Developer Foundations). Wait until the page says you have access.

Then create a token with Read access at huggingface.co/settings/tokens. TGI uses it to download the model.
Start MedGemma-Text with TGI
On your GPU server (1 × 80 GB GPU or more), run:
docker run -d --rm --name tgi --gpus all --shm-size 1g \
-p 127.0.0.1:8080:80 \
-v $PWD/data:/data \
-e HF_TOKEN=hf_your_token \
ghcr.io/huggingface/text-generation-inference:3.3.5 \
--model-id google/medgemma-27b-text-it \
--num-shard 1 \
--cors-allow-origin https://www.typingmind.com- Replace
hf_your_tokenwith your Hugging Face token. -dkeeps TGI running after you close the terminal.-p 127.0.0.1:8080:80serves TGI on port 8080 of your server, for connections from the server itself only. The SSH tunnel in step III is one of them.-v $PWD/data:/datakeeps the downloaded model, so the next start is fast.--num-shard 1keeps the model on one GPU, even if your server has more.--cors-allow-origin https://www.typingmind.comlets only the TypingMind web app call TGI from a browser, not other websites you visit.
The first start downloads 54 GB of model weights, so it can take a while. Follow along with:
docker logs -f tgiTGI is ready when the log prints Connected. Press Ctrl+C to stop following the log, then check it with:
curl http://localhost:8080/v1/chat/completions \
-H 'Content-Type: application/json' \
-d '{"model": "tgi", "messages": [{"role": "user", "content": "Say hi"}]}'You should get a JSON reply with the model's answer.
Connect your computer to TGI
TypingMind runs on https://, so your browser blocks calls to a plain http:// server, unless the server is at localhost. An SSH tunnel makes TGI show up at localhost:8080 on your computer. On your computer, run:
ssh -N -L 8080:localhost:8080 user@your-gpu-serverReplace user@your-gpu-server with how you log in to the server, and keep this terminal open while you chat. Skip this step if TGI runs on the computer you use for TypingMind.
Add MedGemma-Text to TypingMind
Open www.typingmind.com in your browser. Use the web version: the TypingMind Mac app and the Setapp version block plain http:// addresses like TGI's.
Click Models in the left sidebar, then Add custom model.
Fill in the form:
| Name | medgemma-27b-text-it (TGI)or any name you like |
| Model ID | google/medgemma-27b-text-it |
| Context Length | 32768lower it if TGI rejects long chats |
| API Type | OpenAI Chat Completions API |
| Endpoint URL | http://localhost:8080/v1/chat/completions |
| Authentication Type | No authentication |
medgemma-27b-text-it (TGI)google/medgemma-27b-text-it32768http://localhost:8080/v1/chat/completionsOpen the Capabilities tab and turn off Auto check capabilities on save, so TypingMind keeps the features you set below.
Then set the features for MedGemma-Text:
- Support System Role: on
- Support Streaming Output: on
- Support Plugins: off
- Support Image Input: off
- Support PDF Input: off
- Support External Image URLs: off
- Support Thinking: off
- Support Prompt Caching: off
Click Test & Save. If your browser asks to let www.typingmind.com access other apps and services on this device, click Allow. This lets the page reach TGI at localhost.
Chat with MedGemma-Text in TypingMind
Pick medgemma-27b-text-it (TGI) in the model menu under the chat box and say hi. Replies come straight from your own GPU server.


medgemma-27b-text-it (TGI)You can now use your private AI with TypingMind's chat features: prompts, AI agents, projects, and switching between your self-hosted model and cloud models in the same chat.
Tips and troubleshooting
1. "Could not connect to the API (code: 1)"
TypingMind can't reach TGI. Check these in order:
- The SSH tunnel is still open. If you closed its terminal, run the tunnel command from step III again.
- TGI is still running on the server:
docker psshould listtgi. If it's gone, run the command from step II again. - TGI answers on the server. Run this on the server:
curl http://localhost:8080/v1/chat/completions \
-H 'Content-Type: application/json' \
-d '{"model": "tgi", "messages": [{"role": "user", "content": "Say hi"}]}'- You clicked Allow when the browser asked about accessing apps on this device.
- You're using TypingMind in the browser, not the Mac or Setapp app.
2. TGI stops with "CUDA out of memory"
The model is too big for your GPU. Add GPUs and split the model across them with --num-shard.
3. TGI can't download the model (401 or 403)
The model needs access approval. Accept its license on Hugging Face, then pass your token with -e HF_TOKEN=hf_your_token.
4. Long chats fail with a token limit error
TGI fits the context window to your GPU memory. Lower Context Length in the TypingMind model settings.
5. The first message of a new chat seems stuck
TypingMind writes a title for each new chat. If the title is made by the same model, your reply can wait behind the title. Go to Settings → Internal prompts, open Advanced Settings under Auto generate title for new chats, and pick another model for title generation, or turn auto titles off.
6. See what TGI is doing
Watch every request as it happens:
docker logs -f tgiTGI runs one model at a time. To switch models, stop it with docker stop tgi and start it again with a new --model-id.
Frequently Asked Questions
Is MedGemma-Text free to run with TGI?
Yes. TGI is free and open source, and MedGemma-Text is an open model. MedGemma-Text needs access approval on Hugging Face, so accept its license and use a Hugging Face token to download it. You only pay for your own GPU server, with no per-message cost.
Is MedGemma-Text private when I run it with TGI?
Yes. Your messages go from your browser to TGI on your own server, not to an AI company. TypingMind keeps your chat history in your browser. If you turn on Cloud Sync, your chats are also backed up to TypingMind's cloud.
How much GPU memory do I need for MedGemma-Text?
google/medgemma-27b-text-it, the version used in this guide, needs about 1 × 80 GB GPU.
Which Model ID do I use in TypingMind?
TGI serves one model per server, so it does not use the Model ID to pick a model. Use the Hugging Face model ID, for example google/medgemma-27b-text-it, so you can tell your models apart in TypingMind.
Can MedGemma-Text use TypingMind plugins?
MedGemma-Text's chat template doesn't list tool use, so keep Support Plugins off. Pick a model with tool calling if you need plugins.
Can MedGemma-Text read images?
No. MedGemma-Text is a text model, so keep Support Image Input off.
Can I run TGI on my Mac or laptop?
Not really. TGI is built for NVIDIA GPUs, and Docker on a Mac cannot use the Mac's GPU. On a Mac or a laptop, use Ollama or LM Studio instead.
Does TypingMind run locally?
TypingMind runs in your browser at www.typingmind.com, and your chats are stored locally in your browser by default. When you chat with a self-hosted model, your messages go straight from your browser to the model on your own GPU server, not through TypingMind’s servers. If you turn on Cloud Sync, your chats are also backed up to TypingMind’s cloud.
Can I self-host TypingMind?
Yes. To self-host TypingMind for your team or company, use the self-hosted version of TypingMind Teams. You run it on your own servers next to your self-hosted models, so chats, users, and settings stay inside your own infrastructure. Contact our sales team to get started.
Hugging Face TGI

