Development & infrastructure

Decision matrix

Text Generation Inference runtime decision matrix
Overview

Text Generation Inference (TGI) is Hugging Face's open-source server for running language models behind an API on your own GPUs. Hugging Face has put it in maintenance mode, archived the GitHub repository and now recommends vLLM or SGLang. Read this if you already run TGI and plan the move; don't start new projects on it.

Other good fits
  • Working out what an inherited TGI deployment does: which endpoints clients call and what a replacement must offer.
Pros
  • Pick it when you inherit a working TGI server and need to keep clients running while you migrate.
  • Pick it when your clients use its /generate route or its OpenAI-compatible /v1/chat/completions route, and you need to know what a replacement must offer.
  • Pick it when you have a Hugging Face Inference Endpoint set up with the TGI engine. That engine is still offered, but Hugging Face recommends vLLM or SGLang for new endpoints.

TGI was built for serving: continuous batching, token streaming, tensor parallelism across GPUs, quantisation, and Prometheus and OpenTelemetry monitoring. That is why many older deployments still run it.

Cons
  • Pick something else when you start fresh: vLLM is the engine Hugging Face points to, with a new release about every two weeks.
  • Pick something else when a few people share one machine: Ollama or llama.cpp are simpler to run.
  • Pick something else when you serve models across a Kubernetes cluster: llm-d routes requests across pools of model servers.

Avoid if

  • You need support for new model architectures or more than small fixes. The project no longer takes feature work.
Requirements

A running TGI server needs a selected compatible model, its weights and hardware-specific installation route. The official quick tour demonstrates a GPU-backed Docker container, a model cache volume and port 8080. Select the NVIDIA, AMD, Intel, Gaudi, Inferentia or other documented hardware guide for the actual deployment; this review establishes no hardware minimum.

First run

Documentation-based suggestion — not run here.

Read first run

Plan the move off TGI for a small company's internal chat assistant that runs on one GPU server.

  1. Write down what you run: the Docker image tag (the last release is v3.3.7), the model ID, and launch flags such as --max-total-tokens and --quantize.
  2. List what your clients call. Apps on /v1/chat/completions can switch servers by changing the base URL. Apps on /generate need a code change.
  3. Start vLLM on a second port with the same model: vllm serve <model-id> --port 8001.
  4. Send the same 20 real prompts to both servers and compare the answers and response times.
  5. Move one client to vLLM for a week, then retire the TGI container.
Integration

Use /generate for non-chat completion or /v1/chat/completions for the documented OpenAI-compatible Messages API. Keep a locally bound service local unless the operator deliberately adds authentication, transport and network controls.

Check the result

Expect a JSON object with generated_text; inspect whether it completes the sample caption and whether the 40-token cap cuts it off. No server, request or model output was observed for this review.

Links & evidence
Documentation-based · not hands-on · Sep 23, 2026

Based on Hugging Face's TGI documentation and maintenance notice, the Inference Endpoints TGI page and the archived GitHub repository with its release list, checked 23 September 2026. We did not run it for this review.

  • TGI documentation · Sep 23, 2026 — Maintenance-mode notice (minor fixes only); recommends vLLM, SGLang, llama.cpp or MLX; feature list (batching, streaming, tensor parallelism, quantisation, metrics).
  • TGI GitHub repository · Sep 23, 2026 — Repository shown as a public archive (read-only); Apache-2.0 licence.
  • TGI releases · Sep 23, 2026 — Last release v3.3.7, published 19 December 2025.
  • Inference Endpoints: TGI engine · Sep 23, 2026 — TGI still offered as an engine; Hugging Face recommends vLLM or SGLang as alternatives.
  • Consuming TGI · Sep 23, 2026 — The /generate route and the OpenAI-compatible /v1/chat/completions route.
Further review notes & alternatives

Costs and operating effort

Prices checked 23 September 2026: free software (Apache-2.0); you pay for the machine. A typical setup is a Linux server with an NVIDIA GPU sized to the model, for example a 24 GB card for a 7-8B model in 16-bit.

  • The running cost grows over time. There are no new features and only minor fixes, so newer models may not load and security fixes may not come.
  • Keep the server on an internal network behind authentication; TGI has no user accounts of its own.
  • The migration is a one-off job: a day or two for a single server with a handful of clients, longer if many apps call /generate directly.

Alternatives and trade-offs

  • vLLM: the default replacement. It offers OpenAI- and Anthropic-compatible APIs and supports new models quickly.
  • SGLang (not in this catalogue): the other engine Hugging Face recommends.
  • llama.cpp: wins on a single machine or a Mac, with GGUF model files.
  • LiteLLM: put it in front of both servers during the move, so clients keep one URL while you switch.

Learn more

Catalogue facts

Deploy open language models behind an inference service using Docker. Stream tokens and serve concurrent requests with batching and parallelism. Use quantization across supported GPUs, accelerators, or CPUs.

free · self-host

  • inference server
  • continuous batching
  • token streaming
  • tensor parallelism
  • hugging face
  • open-source

Browse all tools