Delorun user guide
English | 中文
Summary
The user guide is for people who install and use Delorun, the community fork of DeepSeek Harness, whether new to both or switching from stock DeepSeek Harness. Delorun runs on your own computer. This page is a map: find what you want to do, and follow the link to the page and section. If you are new, read Install and first run first, then Daily use. Technical terms link to the glossary.
Contents
- I want to get started
- I want to use it every day
- I want to choose or change the model
- I want to reach it from my phone
- I want to make it mine
- I want to know what is safe
- Something went wrong
- For the technically curious
I want to get started
- Install Delorun and have a first chat: Install and first run. It covers what you need first, setup by how you will use Delorun, the studio and your first chat and a computer without a browser.
- Bring my DeepSeek Harness chats: Switching from DeepSeek Harness. It explains what is copied, what is held back and how to go back.
- See how Delorun differs from stock DeepSeek Harness: Delorun and stock DeepSeek Harness. It lists every difference and what Delorun does not include.
- See what Delorun is for and where it is going: Roadmap and vision. It lists the planned work in order, and what is not planned.
I want to use it every day
- Start, open, stop or check Delorun: Start, open and stop and Check the release and your setup.
- Decide what the model may change in a folder: Workspaces and what the model may change.
- Recover from a plugin that stops Delorun starting: Safe mode and recovery.
- Restore a deleted chat, or move chats between homes: Trash, export and import.
- Move to a new release, or back: Updates and Going back.
- Update when I run many third-party plugins: Update Delorun with many plugins. It covers what is saved first, reading the report's
disabledlines, trying a plugin anyway with a version exemption, and going back. - Find where my data lives, move it, or use two profiles: Your Delorun home.
- Find out why something failed: Where Delorun keeps its logs.
- Bring my chats from the DeepSeek website: Import your DeepSeek website chats.
- See what a chat costs: See what a chat costs.
- Read the model's thinking word by word: Read the model's thinking word by word.
I want to choose or change the model
- Pick a provider and key, or run a model on my own computer: Model providers. It lists every provider setup knows and how to change the provider later.
I want to reach it from my phone
- Turn on remote access, approve a device, or remove one: Reach the studio from your phone.
I want to make it mine
- Choose the right way to change Delorun: Where to customise what compares settings, the profile patch, agent presets, your own plugin, a renamed fork of a shipped plugin and editing Delorun itself, with what each costs you at every update.
- Write a plugin: Write a plugin for Delorun goes from
delorun plugin newto a plugin that loads in your studio. - See, protect or undo changes: Changing your harness explains what
delorun changesrecords, protection, and undo.
I want to know what is safe
- Understand the sandbox, full access and the consents: What Delorun protects.
- Understand prompt injection and what leaves my computer: Prompt injection and data exfiltration.
- Know what I trust when I use Delorun: What you trust when you use Delorun.
Something went wrong
- A message or code I do not understand: Troubleshooting. It explains how to read a refusal and lists the common ones by code, with fixes.
- Delorun does not start: Starting and stopping, then
delorun doctor(Daily use). - An update failed: Updates and rollback.
For the technically curious
These pages describe what you see and do. The delorun/docs/README.md leads to the contracts, designs and threat model that define the exact rules; each guide page ends with links to the ones it relies on.