Soup: Single-YAML LLM Fine-Tuning on Consumer GPUs

RepositoryMakazhanAlpamys/SoupTool

Soup (soup-cli) is an open-source tool designed to fine-tune language models via a single YAML configuration file and a unified CLI command. By leveraging layer streaming, it allows users to train 8B models on consumer hardware with as little as 4 GB of VRAM.

Key points

  1. Enables LLM fine-tuning and post-training via one YAML file without complicated SSH or cluster configurations.
  2. Uses layer streaming to run training for 8B models on laptop GPUs with 4 GB VRAM.
  3. Provides both a command-line interface (CLI) and a web-based user interface.
  4. Built on Python (3.10–3.12) and integrates with PyTorch, Hugging Face Transformers, PEFT, LoRA/QLoRA, and DPO.
  5. Supports exports and workflows for formats such as GGUF and runtimes like Ollama.

Why it matters

Fine-tuning models locally often fails due to prohibitive GPU memory requirements and fragile tooling setups. Soup eliminates these barriers by making efficient adaptation workflows accessible on standard developer laptops.

Analysis

Soup tackles the persistent VRAM barrier in local LLM training. Architecturally, it links standard machine learning components (PyTorch, Transformers, PEFT, QLoRA) with layer-streaming techniques to heavily reduce runtime memory footprint. It is targeted at software engineers, AI researchers, and teams looking to adapt models locally without reliance on costly cloud clusters. Backed by over 7,400 GitHub stars, an active PyPI package (soup-cli), CI workflows, and multi-language documentation, the project demonstrates significant maturity and community traction.

Found in

Summary generated by AI (Gemini 3.8 Flash, 29 September 2026). It may contain errors – the original source is authoritative.

Similar in content, found by the AI search.

  • Repository:empero-org/brewery-ai

    Brewery: Guided Console Agent for Fine-Tuning Text and Vision Models

    Brewery (formerly Homebrew) is an interactive console agent developed by Empero that assists users through the entire fine-tuning lifecycle for language and image models, from setup to publishing on Hugging Face.

    189starsPython

    AI & LLMs· Tool

  • Repository:unslothai/unsloth

    Unsloth: Desktop Application to Run and Train Local AI Models

    Unsloth is an open-source cross-platform desktop application and framework designed to run and fine-tune large language models and diffusion architectures locally across varied hardware setups.

    75.7kstarsPython

    AI & LLMs· Tool

  • Repository:volotat/mini-AGI

    mini-AGI: Byte-Level Continual Learning on 8 GB VRAM Consumer Hardware

    mini-AGI is an experimental open-source byte-level language model designed to demonstrate continual learning from a single stream of data (batch size 1) on modest 8 GB VRAM hardware. By paging model weights from disk into GPU memory as needed, it decouples parameter capacity from VRAM limits while dynamically scaling its architecture.

    793starsPython

    AI & LLMs· Research

  • Repository:LMCache/LMCache

    LMCache: Scalable KV Cache Management Layer for LLM Inference

    LMCache is an Apache-2.0 open-source caching layer designed to accelerate LLM serving by optimising and sharing Key-Value caches across processes and network nodes on Nvidia and AMD hardware.

    11.7kstarsPython

    AI & LLMs· Tool

  • Repository:drumih/turbo-fieldfare

    TurboFieldfare: Gemma 4 26B-A4B Inference in 2 GB RAM on Apple Silicon

    TurboFieldfare is a dedicated Swift and Metal runtime designed to run Google's Gemma 4 26B-A4B on Apple Silicon Macs within an approximately 2 GB RAM budget. It avoids loading the full 14.3 GB model into memory by keeping only the 1.35 GB core and KV cache in RAM while streaming the required mixture-of-experts weights from SSD on demand.

    6.6kstarsSwift

    AI & LLMs· Tool

Let's talk about your project

Locations

  • Mattersburg
    Johann Nepomuk Bergerstraße 7/2/14
    7210 Mattersburg, Austria
  • Vienna
    Ungargasse 64-66/3/404
    1030 Wien, Austria

Parts of this content were created with the assistance of AI.