Local AI Agent on ZimaOS

Overview

You have two pieces running on your NAS: DeepSeek Harness, a coding agent, and a local LLM server that answers at 65–70 tokens per second. This guide connects them and starts your first fully local task.

From that point on, your agent has no API bill, no rate limits, and no data leaving home. Run as many tasks as you want — data processing, automation, smart-home monitoring — around the clock on your own hardware.

Before You Start

Connect the Agent to Your Local Server

  1. Open DeepSeek Harness and go to Settings > Models.

  2. Add a model provider:

Field Value
Base URL http://<your-nas-ip>:8080/v1
API key Any placeholder, such as sk-none — the server does not authenticate
  1. Click Fetch available models. DeepSeek Harness queries the local server and lists the models it serves. The local model appears in the list, ready to use.

  2. The model’s behavior was measured, not guessed — see the RTX PRO 2000 Performance Test for the full findings. One point matters in use: temperature is set at server launch (the deployment guide uses 0.7 — never 0, greedy sampling makes the model repeat itself forever).

  3. Context starts at 128K. Agent conversations grow, and this model’s native window is 256K. Start the server with a 128K context on a 16 GB card (tight but workable, verified at 14.8 GB), or reach the full 256K with KV q4 on a 20 GB card — the RTX 4000 SFF Ada page has the verified command.

  4. In the chat dialog, select the local model before sending. Every conversation from then on runs on your own hardware. Send a short message and confirm the reply arrives. If you want proof it came from your own machine, watch the server logs while it answers.

Start Your First Task

Pick one, paste it into a session, and let the agent work. Each prompt below is a starting point — the agent plans the details, and you steer in the conversation.

Process local data.

Go through the Documents folder on the NAS, list what is in there, group the files by topic, and write a summary index in Markdown. Do not modify or delete any files without asking me first.

Automate a recurring chore.

Set up a daily job at 23:00 that checks the Downloads folder, moves files older than 30 days into an Archive folder sorted by month, and writes a short log of what it moved.

Watch your hardware with a smart-home style alert.

Monitor this NAS’s disk temperature and free space. If the temperature passes 55 °C or free space drops below 10%, write a health report and make it visible so I can review it.

Keep It Running 24/7

The agent runs on the NAS itself, so long-running tasks keep working while your laptop is closed. Check progress from your phone through ZimaClient — the same Web UI, anywhere. The DeepSeek Harness guide covers the mobile access and the folder authorization the agent needs for file tasks.

When Something Breaks

  • Replies repeat forever. The temperature is 0 — see the note above.
  • Speed suddenly dropped. Part of the model fell back to CPU. The local LLM guide has the full fix list.
  • The agent cannot reach the model. Open http://<your-nas-ip>:8080/v1/models in a browser on your LAN. A JSON list means the server is up and the problem is in the Base URL field; an error means the server itself needs a restart.

Reference Links