From 705abff7a332caf52df409ef8a4e903968292a87 Mon Sep 17 00:00:00 2001
From: yanalialiuk <ylialuke@gmail.com>
Date: Tue, 19 May 2026 14:49:04 +0300
Subject: [PATCH] Document local setup for NanoBot with Atomic Chat

Added instructions for running NanoBot locally using Atomic Chat.
---
 README.md | 30 +++++++++++++++++++++++++++++-
 1 file changed, 29 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 99c5ea2c4..ec8c5c3ac 100644
--- a/README.md
+++ b/README.md
@@ -188,7 +188,35 @@ Configure these **two parts** in your config (other options have defaults). Add
   }
 }
 ```
+*Run NanoBot Locally* (No Cloud)
 
+Use a local model instead of a hosted API provider.
+
+| Step | What to do |
+|---|---|
+| 1 | Install [Atomic Chat](https://atomic.chat/) on your machine. |
+| 2 | Open Atomic Chat, download a model, and keep the app running (the local API is enabled by default). |
+| 3 | In Atomic Chat, copy the model ID exposed by the local API. For example, the model ID for `Qwen 3 32B` might be `qwen3-32b`. |
+| 4 | Open `~/.nanobot/config.json` and add the Atomic Chat provider settings shown below. Replace the example model ID with the one from Step 3. Merge this into your existing config instead of replacing the whole file. |
+
+Example:
+
+```json
+{
+  "providers": {
+    "atomic_chat": {
+      "apiKey": null,
+      "apiBase": "http://127.0.0.1:1337/v1"
+    }
+  },
+  "agents": {
+    "defaults": {
+      "provider": "atomic_chat",
+      "model": "qwen3-32b"
+    }
+  }
+}
+```
 **3. Chat**
 
 ```bash
@@ -316,4 +344,4 @@ This project was started by [Xubin Ren](https://github.com/re-bin) as a personal
 <p align="center">
   <em> Thanks for visiting ✨ nanobot!</em><br><br>
   <img src="https://visitor-badge.laobi.icu/badge?page_id=HKUDS.nanobot&style=for-the-badge&color=00d4ff" alt="Views">
-</p>
\ No newline at end of file
+</p>