Skip to content

The ultimate harness for coding agents and beyond. All your agents. All your machines. One command center. Start with code, then follow your curiosity and build across disciplines: CAD, circuits, robots, games and music.

docs(hn): download and start a local model, step by step

bitcoinbuilder007bbf5419a6
diff --git a/docs/hn-local-models.md b/docs/hn-local-models.md
new file mode 100644
index 000000000..461b0d8e9
--- /dev/null
+++ b/docs/hn-local-models.md
@@ -0,0 +1,47 @@
+# Download and start a local model in hn
+
+A local model runs on your own computer instead of a provider's servers.
+
+## 1. Install hn
+
+In a terminal, run:
+
+```
+curl -fsSL https://harness.autonomous.ai/cli/install.sh | bash
+```
+
+Then type `hn` and press Enter. The first time, hn signs you in.
+
+## 2. Open a harness
+
+Open the harness that will use the local model: press Ctrl+B, then Shift+N, choose an agent with the Up and Down arrow keys and press Enter. Claude Code, Codex, OpenCode can use local models.
+
+![Choosing an agent for a new harness](images/hn-local-models/open-harness.png)
+
+## 3. Open Models
+
+In the harness, press Ctrl+B, then Shift+I. The Models screen opens for that harness.
+
+If you see **Set up local & shared models**, press Enter on it first.
+
+![Models, opened for the harness](images/hn-local-models/open-models.png)
+
+## 4. Choose a model
+
+**Get for this computer** is the model catalog: models that fit this computer's memory (on NVIDIA, its GPU's VRAM), ranked for coding. Each row shows the download size and estimated speed.
+
+Use the Up and Down arrow keys to select a model, then press Enter twice.
+
+![A model selected, with its details on the right](images/hn-local-models/choose-model.png)
+
+## 5. Wait
+
+hn downloads the model, starts it and moves your harness onto it. Downloads are often 10–20 GB. If one stops, press Enter twice on the model again to resume it.
+
+![Downloading](images/hn-local-models/downloading.png)
+
+## 6. Done
+
+Your agent now answers with the local model.
+
+![The agent answering with the local model](images/hn-local-models/agent-answering.png)
diff --git a/docs/images/hn-local-models/agent-answering.png b/docs/images/hn-local-models/agent-answering.png
new file mode 100644
index 000000000..77164fdf2
Binary files /dev/null and b/docs/images/hn-local-models/agent-answering.png differ
diff --git a/docs/images/hn-local-models/choose-model.png b/docs/images/hn-local-models/choose-model.png
new file mode 100644
index 000000000..d68d6d056
Binary files /dev/null and b/docs/images/hn-local-models/choose-model.png differ
diff --git a/docs/images/hn-local-models/downloading.png b/docs/images/hn-local-models/downloading.png
new file mode 100644
index 000000000..1cc59829d
Binary files /dev/null and b/docs/images/hn-local-models/downloading.png differ
diff --git a/docs/images/hn-local-models/open-harness.png b/docs/images/hn-local-models/open-harness.png
new file mode 100644
index 000000000..c9ef25572
Binary files /dev/null and b/docs/images/hn-local-models/open-harness.png differ
diff --git a/docs/images/hn-local-models/open-models.png b/docs/images/hn-local-models/open-models.png
new file mode 100644
index 000000000..3e0401aaf
Binary files /dev/null and b/docs/images/hn-local-models/open-models.png differ