local-llm-readiness
v0.1.3
Published
Is this machine ready to run local-LLM agents unattended? Checks distilled from a real 115-agent, 24/7 Ollama operation.
Downloads
597
Maintainers
Readme
local-llm-readiness
Is this machine ready to run local-LLM agents unattended?
One command. Zero dependencies. Every check is a hole we actually fell into while running 115 autonomous agents on Ollama, 24/7, on one machine — not a theoretical best-practice list.
npx local-llm-readinessWhat it checks(全項目が実際に事故った箇所)
| check | the incident behind it |
|---|---|
| RAM / WSL memory cap | a 35B-A3B model resident at 21.7 GB; inside WSL you only see the WSL allotment |
| Disk free | models + daily logs quietly ate the disk |
| Ollama reachable / model count | the server answered while one model hung — reviews silently stopped for 4.5 h |
| Sleep suppression | the PC entered connected standby 8–22 times a day; 40% of scheduled jobs never fired. Power-plan settings did NOT stop it — only a process holding a power request did |
| Parallelism consistency | worker=24 / queue=6 / OLLAMA_NUM_PARALLEL=4 — three different numbers, silent starvation |
| Local-time discipline | new Date().toISOString().slice(0,10) is UTC: 111 call sites stamped yesterday between 00:00–09:00 JST |
Exit code 0 = no blockers. △ items are the ones that break unattended operation later.
📩 Free extras
Extended 24-point checklist + 3 battle-tested harness templates (AGENTS.md, fail-closed send gate, missed-fire watcher) — free at https://gxcafe.co.jp/harness-kit/?utm_source=npm-readiness&utm_medium=readme&utm_campaign=harness-kit
Related (same team, same logs)
honto-contract— did the agent's answer actually work? A contract checker.- ai-agent-failure-logs — 3,400+ recorded failures (CC BY 4.0).
Honest note: we have no customers yet. These tools are exactly what we run on ourselves.
The rest of the harness
Harness Templates Pro — US$59 (excl. tax)
7 standalone templates + README + test suite (one-time purchase, single-organization commercial license)
The guards that catch a cron that never fired, a job that succeeds daily with zero output, an approved deliverable nobody picked up, and a lock that starves long jobs. Each file is standalone, zero-dependency Node.js. Each one exists because its absence cost us real days; the incident behind each is written at the top of the file.
You do not need it to use anything here. What is on this page is free and stays free.
Single-organization commercial licence. Prices are exclusive of tax; the tax that applies to your location is added at checkout. Delivered by email after purchase. Japanese commercial-transaction disclosure.
