LibreAI / Local LLM / nano-vllm
// local-llm · GeeeekExplorer/nano-vllm

nano-vllm

A lightweight vLLM implementation built from scratch in about 1,200 readable lines of Python.

★ 15.7k stars⑂ 2.7k forksMITupdated 2026-04
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

nano-vllm is an open-source local llm project by GeeeekExplorer (GeeeekExplorer/nano-vllm on GitHub). It has 15,743 GitHub stars and 2,666 forks, is released under the MIT license, and was last updated on GitHub on 26 April 2026.

GitHub stars
15,743
Forks
2,666
License
MIT
Last updated on GitHub
26 April 2026
Category
Local LLM
Listing
Full install guide
// how it works

How it works

  1. Decide if you want speed or understanding

    Choose nano-vllm to run offline inference with a codebase small enough to read fully, or to prototype engine ideas quickly.

  2. Install the package

    Install nano-vllm directly from its GitHub repository with pip.

  3. Download model weights

    Fetch a model such as Qwen3-0.6B from Hugging Face to a local directory.

  4. Generate text

    Load the model with the LLM class, set SamplingParams, and call generate on your prompts, as in example.py.

// features

Why people love it

Readable from-scratch engine

The whole implementation is about 1,200 lines of clean Python, so you can actually read how inference works.

Fast offline inference

The README benchmark shows output throughput comparable to vLLM on the tested setup (Qwen3-0.6B, RTX 4070 Laptop).

Prefix caching

Reuses cached prefixes across requests to avoid recomputing shared prompt beginnings.

Tensor parallelism

Splits a model across multiple GPUs with the tensor_parallel_size setting when one GPU is not enough.

Torch compilation and CUDA graphs

Uses torch compilation and CUDA graphs as part of its optimization suite to cut inference overhead.

vLLM-like API

The LLM and SamplingParams interface mirrors vLLM, so existing vLLM-style code needs only minor changes.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Clone nano-vllm to read the source and run the included example and benchmark scripts.

    git clone https://github.com/GeeeekExplorer/nano-vllm.git
    cd nano-vllm
  2. Install from GitHub

    Install the package directly from the repository with pip.

    pip install git+https://github.com/GeeeekExplorer/nano-vllm.git
  3. Download a model and generate

    Download Qwen3-0.6B weights, then run example.py-style code with the LLM class and SamplingParams.

    huggingface-cli download --resume-download Qwen/Qwen3-0.6B --local-dir ~/huggingface/Qwen3-0.6B/ --local-dir-use-symlinks False
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains nano-vllm?

It is a project by GeeeekExplorer with open-source contributors.

Is nano-vllm free to use?

Yes. It is released under the MIT license.

Does it need a paid API key?

No. It runs models locally on your GPU; you only download open model weights from Hugging Face.

How does it compare with vLLM itself?

Nano-vLLM trades vLLM's breadth (serving features, model coverage, production hardening) for a tiny, readable codebase with comparable offline throughput on the README's tested setup.

How do I get started?

pip install it from GitHub, download Qwen3-0.6B, and run the example in example.py.

// keep exploring

Similar tools

Local LLM

code-context-engine

Code-context-engine, in Python — built for save 94% on ai coding tokens. index your cod...

★ 425 starsMIT
View guide →
Local LLM

GoModel

Go-built AI gateway unifying many providers with routing and guardrails.

★ 1.2k starsMIT
View guide →
Local LLM

vllm-omni

vLLM-Omni — efficient inference for omni-modality models: image, audio, video, diffusion and policies.

★ 7.1k starsApache-2.0
View guide →
Local LLM

WebMCP

Early proposal and implementation for connecting LLMs to web pages.

★ 883 starsMIT
View guide →
Local LLM

chatgpt-subtitle-translator

Token efficient translation utility built on ChatGPT or any OpenAI compatible LLM.

★ 389 starsMIT
View guide →
Local LLM

gemma

Google DeepMind's Gemma open-weight LLM library — install, load and chat with Gemma models in Python.

★ 5.8k starsApache-2.0
View guide →
// alternatives

Alternatives in Local LLM

The most-starred other Local LLM projects in the LibreAI catalogue — the realistic shortlist if nano-vllm is not the right fit.

Get nano-vllm

Free and open — grab the source, star the repo, and start creating.