MakazhanAlpamys/Soup
Fine-tune LLMs from one YAML. Layer streaming trains an 8B model on a 4 GB laptop GPU.
Build with Backblaze B2
SDKs, agent skills, IDE extensions, and reference pipelines from Backblaze Labs. All open source.
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.
Daily snapshots
Stars gained per day, and how forks and open issues moved, from GStars' daily snapshots
+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
| Repository | Stars | +7d | Health | Last release |
|---|---|---|---|---|
| morluto/rea | 450.0K | +22.9K | 75 | 16 days ago |
| mattpocock/skills | 320.9K | +9.5K | 75 | 12 days ago |
| vercel-labs/agent-desktop | 21.4K | +8.7K | 75 | 5 days ago |
| stablyai/orca | 121.4K | +6.7K | 75 | today |
| vercel-labs/agent-browser | 49.2K | +3.8K | 75 | 1 day ago |
| MakazhanAlpamys/Soup | 10.1K | — | 65 | 6 days ago |
| Category median | 121.4K | +8.7K | 75 | — |
Discover Repositories
Search across tracked repositories by name or description