Who it is forA developer or team lead deciding whether a local open-weight model can serve a planned number of users on a specific laptop, workstation, or GPU box.
The problemModel file size alone does not show whether KV cache, concurrency, token speed, and time to first token will fit in the memory that is actually free.
The outcomeYou get three separate answers: the physical load ceiling, the practical ceiling with a minimum speed, and the ceiling that meets your target. Each candidate shows weights, KV cache, workspace, and risk reasons.
What you need first
- Python 3.10 to 3.12 installed on Windows, macOS, or Linux
- A local copy of the repo from https://github.com/keith-yan/vibe-service-guardian
- Permission to run a local web console bound to 127.0.0.1
Steps
- Start the console with
python -m vsg --open. - Open the model capacity page and let it read CPU, memory, disk, GPU or unified memory, and installed local runtimes.
- Enter planned users, peak concurrency, average input and output tokens, per-session context, target tokens per second per user, and target time to first token.
- Review each candidate's weights, KV cache, workspace, per-user throughput range, and the maximum concurrency under target.
- Copy the generated run command template, which is fixed to 127.0.0.1 and is not executed automatically, and test it on the real machine before relying on it.
Prompt for your agent
Using keith-yan/vibe-service-guardian, open the model capacity page with `python -m vsg --open`, enter the plan for <number of users> users at <peak concurrency> concurrency, and report the physical, practical, and target SLA ceilings for <model name>. Verify that each figure lists its risk reasons and that the result is treated as an estimate until a local benchmark is run.
Caveat. The capacity output is a planning estimate and does not replace a same-load benchmark, and the built-in model catalog is a dated offline snapshot rather than a full list.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for keith-yan/vibe-service-guardian and "Check whether an open-weight model fits your machine before you download it"
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer