#
Text Generation Inference (TGI)

> Text Generation Inference is in maintenance mode as of 12/11/2025. This means that only pull requests for minor bug fixes, documentation improvements, and lightweight maintenance tasks will be accepted.

> For Inference Endpoints, we recommend using our available inference engine options, such as vLLM or SGLang, as alternatives.

> Below is a quick migration guide if you already have an Inference Endpoint deployed with TGI.

##
Migration Guide

Here are the steps to migrate an Inference Endpoint from TGI to vLLM. Since the Inference Engine cannot be changed on an existing Inference Endpoint, you must create a new one to complete the transition.

1. Create a new Inference Endpoint with the same model, selecting vLLM as the Inference Engine. You can typically use the same hardware and configuration.
2. Once the new Inference Endpoint is running, make a few test calls to ensure it functions correctly.
3. Switch traffic from the old Inference Endpoint to the new one.
4. Finally, pause or delete the old Inference Endpoint.

##
Introduction

TGI is a production-grade inference engine built in Rust and Python, designed for high-performance serving of open-source LLMs (e.g. LLaMA, Falcon, StarCoder, BLOOM and many more). The core features that make TGI a good choice are:

- Continuous batching + streaming: Dynamically groups in-flight requests and streams tokens via Server-Sent Events (SSE)
- Optimized attention & decoding: TGI uses Flash Attention, Paged Attention, KV-caching, and custom CUDA kernels for latency and memory efficiency
- Quantization & weight loading speed: Supports quantizations methods like bitsandbytes and GPTQ and uses Safetensors to reduce load times
- Production readiness: Fully OpenAI-compatible `/v1/chat` or `/v1/completions` APIs, Prometheus metrics, OpenTelemetry tracing, watermarking, logit controls, JSON schema guidance

By default, the TGI version will be the latest available one (with some delay). But you can also specify a different version by changing the container URL

##
Configuration

When selecting a model to deploy, the Inference Endpoints UI automatically checks whether a model is supported by TGI. If it is, you’ll see the option presented under `Container Configuration` where you can change the following settings:

- Quantization: Which quantization method, if any, to use for the model.
- Max Number of Tokens (per query): Changes the maximum amount of tokens a request can contain. For example a value of `1512` means users can send either a prompt of `1000` tokens and generate `512` new tokens, or send a prompt of `1` token and generate `1511` new tokens. The larger this value, the larger amount each request will be in your RAM and the less effective batching can be.
- Max Input Tokens (per query): The maximum number of input tokens, meaning the amount of tokens in the prompt.
- Max Batch Prefill Tokens: Limits the number of tokens for the prefill operation. Prefill tokens are the ones sent in with the user prompt.
- Max Batch Total Tokens: This changes the total amount of potential tokens within a batch. Together with `Max Number of Tokens`, this determines how many concurrent requests you can serve. If you set `Max Number of Tokens` to 100 and `Max Batch Total Tokens` to 100 as well, you can only serve one request at a time.

In general zero-configuration (see below) is recommended for most cases. TGI supports several other configuration parameters and you’ll find a complete list in the TGI documentation. These can all be set by passing the values as environment variables to the container, link to guide.

##
Zero configuration

Introduced in TGI v3, the zero-config mode helps you get the most out of your hardware without manual configuration and trial & error. If you leave the values undefined, TGI will on server startup automatically (based on the hardware it’s running on) select the maximal possible values for the max input lenght, max number of tokens, max batch prefill tokens and max batch total tokens. This means that you’ll use your hardware to it’s full capacity.

> Note that there's a caveat: say you're deploying `meta-llama/Llama-3.3-70B-Instruct`, which has a context length of 128k tokens. But you're on a GPU where you can only fit the model's context three times in memory. So if you want to serve the model with full context length, you can only serve up to 3 concurrent requests. In some cases, it's fine to drop the maximum context length to 64k tokens, which would allow the server to process 6 concurrent requests. You can configure this by setting max input length to 64k and then let TGI auto-configure the rest.

##
Supported models

You can find the models that are supported by TGI:

- Browse supported models on the Hugging Face Hub
- In the TGI documentation under the supported models section
- A selection of popular models in the Inference Endpoints Catalog

If a model is supported by TGI, the Inference Endpoints UI will indicate this by disabling/enabling the selection under `Container Type` configuration.

##
References

We also recommend reading the TGI documentation for more in-depth information.

Update on GitHub