MakazhanAlpamys

    MakazhanAlpamys/Soup

    Fine-tune LLMs from one YAML. Layer streaming trains an 8B model on a 4 GB laptop GPU.

    10.1K stars
    1.7K forks
    10.1K GitHub watchers
    Updated Nov 4, 2026
    View on GitHub

    Build with Backblaze B2

    SDKs, agent skills, IDE extensions, and reference pipelines from Backblaze Labs. All open source.

    Explore Backblaze Labs

    Loading star history...

    Where it stands

    Rank, growth pace and release cadence relative to everything GStars tracks.

    5 releases in the last 90 days, the latest 6 days ago, with 136 contributors on GitHub.

    Use Cases & Benefits

    • Fine-tunes large language models using a single YAML config with layer streaming to enable training 8B models on GPUs with as little as 4 GB VRAM.
    • Enables efficient local fine-tuning by streaming model layers to minimize VRAM usage, eliminating complex setup and SSH dependencies.
    • Use for fine-tuning LLMs on consumer-grade GPUs without cloud resources, enabling accessible model customization.
    • Use for rapid experimentation with various fine-tuning methods like SFT, DPO, and LoRA using simple CLI commands and config files.
    • Use for deploying and exporting optimized models in multiple formats compatible with popular inference engines and local AI frameworks.

    Should you depend on it?

    License terms, project hygiene and risks, from GitHub metadata and GStars' snapshots.

    License

    Apache 2.0

    Permissive: commercial use, modification and redistribution are allowed with attribution; includes an explicit patent grant from contributors.

    Community files

    • README: present
    • Contributing guide: present
    • Code of conduct: present

    Watch-outs

    No watch-outs from GStars' checks.

    General guidance from repository metadata, not legal advice. How we score

    From the README

    Fine-tune and post-train LLMs in one command. No SSH, no config hell.

    Soup turns the pain of LLM fine-tuning into a simple workflow. One config, one command, done.

    Fine-tune an 8B model on a 4 GB laptop GPU. Layer streaming keeps the frozen base out of VRAM and feeds it to the GPU one decoder layer at a time. Measured on an RTX 3050 Laptop 4 GB: Llama-3.1-8B-Instruct + NF4 at 119.6 tok/s, 3.32 GB peak — bit-exact against a normal resident run, and reproduced independently on an H100 at 113.00 tok/s in the same 3.32 GB. (The tok/s figure was measured on v0.72.2, before the v0.73.0 correctness repair that cost −4.8% at 32B; it has not been re-run on a 4 GB card since.) Opt-in (stream_layers: true) and still BETA — how it works · all measurements · paper · check it yourself on a free Colab T4 (caps the process to 4 GB, then asserts a streamed model is bit-identical to a normal one)

    Llama-3.1-8B-Instruct + NF4, LoRA, batch 1, seq 512 on an RTX 3050 Laptop 4 GB — 3.32 GB peak, 119.6 tok/s. Full video (90s)

    Training LLMs is still painful. Even experienced teams spend 30-50% of their time fighting infrastructure instead of improving models. Soup fixes that.

    Excerpt from the MakazhanAlpamys/Soup README on GitHub (Apache-2.0 license). © its authors.Read the full README on GitHub

    Daily snapshots

    Stars gained per day, and how forks and open issues moved, from GStars' daily snapshots

    Aug 16: +392Aug 17: +174Aug 18: +70Aug 29: +89Sep 1: +299Sep 2: +239Sep 3: +408Sep 4: +161Sep 5: +133Sep 6: +108Sep 7: +198Sep 8: +103Sep 9: +51Sep 17: +46Sep 27: +121Sep 28: +80Oct 2: +62Oct 3: +27

    +8,544 stars over 81 days across 28 snapshot days; best day +408 on Sep 3.

    Forks

    1.7K+1.4K

    Open issues

    215+128

    Compared with peers in CLI

    Fastest-growing repositories GStars tracks in this cohort for the week of Nov 8, by 7-day star growth

    MakazhanAlpamys/Soup compared with CLI repositories by stars, 7-day star growth, health score and last release
    RepositoryStars+7dHealthLast release
    morluto/rea450.0K+22.9K7516 days ago
    mattpocock/skills320.9K+9.5K7512 days ago
    vercel-labs/agent-desktop21.4K+8.7K755 days ago
    stablyai/orca121.4K+6.7K75today
    vercel-labs/agent-browser49.2K+3.8K751 day ago
    MakazhanAlpamys/Soup10.1K—656 days ago
    Category median121.4K+8.7K75—

    Discover Repositories

    Search across tracked repositories by name or description