{
 "schema_version": 1,
 "generated": "2026-10-20",
 "id": "hardrave-nightrun--test-nightrun-image-in-qemu",
 "repo": "hardrave/NIGHTRUN",
 "repo_url": "https://github.com/hardrave/NIGHTRUN",
 "repo_slug": "hardrave-nightrun",
 "title": "Test a NightRun image in QEMU before flashing",
 "page_title": "How to test a NightRun image in QEMU before flashing with NIGHTRUN",
 "summary": "Build a NightRun image with a Llama model and boot it in QEMU to check it without touching hardware.",
 "who": "A developer or tinkerer who wants to see the boot and chat flow on a Linux machine before writing to any USB stick.",
 "problem": "Flashing the wrong device or debugging boot problems on real hardware is slow and risky, so an emulator check comes first.",
 "outcome": "A built nightrun.img that boots in a QEMU window and shows the NightRun chat with live status.",
 "steps": [
  "Run `git clone https://github.com/hardrave/NIGHTRUN.git` and then `cd NIGHTRUN`.",
  "Run `curl -L -o models/Llama-3.2-1B-Instruct-Q8_0.gguf https://huggingface.co/bartowski/Llama-3.2-1B-Instruct-GGUF/resolve/main/Llama-3.2-1B-Instruct-Q8_0.gguf`. (inferred, check the README)",
  "Run `cargo run --release -p nrconvert -- models/Llama-3.2-1B-Instruct-Q8_0.gguf models/model.nrm` to convert the model to .nrm. (inferred, check the README)",
  "Run `cargo xtask image --model models/model.nrm` to build nightrun.img.",
  "Run `cargo xtask run --img --mem 4G --window` to boot the image in QEMU."
 ],
 "agent_prompt": "Use the repo hardrave/NIGHTRUN to convert the model at <target> (a GGUF file path) into models/model.nrm and boot it in QEMU with cargo xtask run --img --mem 4G --window. Expected output: a QEMU window showing the NightRun chat prompt. Verify the nrconvert step reports that it re-validated its own output before you boot.",
 "agents": [
  "any"
 ],
 "difficulty": "Intermediate",
 "time": "1 hour 30 minutes",
 "basis": "readme",
 "caveat": "The README lists QEMU as the test path and notes that QEMU rows in its benchmarks come from single scripted runs, so QEMU speed is not a guarantee for real hardware.",
 "category": "Software and DevOps",
 "tags": [
  "Software and DevOps"
 ],
 "lang": "rust",
 "requirements": [
  "A Linux machine with Rust stable and nightly installed",
  "About 6 GB of free disk for a model plus the image",
  "A USB stick (x86_64 target) or microSD card (Raspberry Pi 5 target), or QEMU for testing without hardware",
  "For real hardware: a 64-bit UEFI x86_64 PC with Secure Boot off, or a Raspberry Pi 5"
 ],
 "risk": "none",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [],
 "best": false,
 "score": 0.9,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/hardrave-nightrun/test-nightrun-image-in-qemu/",
 "md": "https://dedupedai.com/use-cases/hardrave-nightrun/test-nightrun-image-in-qemu/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/hardrave-nightrun--test-nightrun-image-in-qemu.json",
 "api_version": "v1"
}
