MuseAI is a free-to-use local AI companion and text-adventure app (no license declared) with a dedicated DSH client plugin that installs it into DeepSeek Harness; data stays local while models run on your own API key.
DSH integration
Compatible
Author-claimed
Safety audit
Unaudited
Last verified
2026-08-21
License
Not specified by the author
01What can it help you accomplish?
Keep a persistent AI companion character alongside your DeepSeek Harness work via the dsh-museai-tavern DSH client plugin
One-on-one character chats where the character responds based on persona, relationship and past memories, with archived memories and bond timelines written back to local character profiles
DeepSeek Harness users who want a local AI companion / role-play experience while they work
Run AI text adventures and enter-the-novel interactive stories with your own characters
DM/GM-driven storylines accepting speech / action / plot inputs, plus playable novel worlds with entry points, playable identities and save-and-resume progress
Players and creators who enjoy character cards, world books, AI TRPG sessions and immersive interactive fiction
Turn novel text or outlines into reusable world books and character cards
Structured world settings and character profiles extracted by AI, reusable across companion chat, text adventure, enter-the-novel and bond-archive modes
Novelists and worldbuilders preparing settings and characters for interactive stories
02How to install into DeepSeek Harness
Prerequisites
- A Windows or macOS desktop machine — installers are provided as .exe / .dmg on the GitHub Releases page
- An API key from OpenAI, Anthropic, or any OpenAI-compatible provider (e.g. DeepSeek, Kimi, Zhipu, Qwen)
Installation steps
- 01
Download the latest installer (.dmg / .exe) from the GitHub Releases page and double-click to install, then launch the app
- 02
macOS only: if the app reports 'damaged and cannot be opened', run `xattr -dr com.apple.quarantine /Applications/MuseAI.app` in Terminal before launching
- 03
Windows only: disable antivirus software (360, Tencent PC Manager, Huorong, Windows Defender, etc.) before installing, then re-enable it afterwards
- 04
On first launch, open Settings, fill in your API Key, API address and model name, then click the connection-test button
- 05
To run MuseAI inside DeepSeek Harness, install the companion DSH client plugin from https://github.com/yejiming/dsh-museai-tavern
Verify the integration
- In Settings, click 「测试连接」 (test connection) after entering the API Key / address / model — a passing test confirms the configuration is correct
03DSH integration and capability boundaries
MuseAI itself is a standalone local AI companion app; the README ships a dedicated DSH client plugin (yejiming/dsh-museai-tavern) that installs MuseAI inside DeepSeek Harness
AI companion chat with long-term memory
world book + character card (name, personality, relationship, backstory)→ongoing one-on-one character chat; archived memories distill key events and update the character card, feeding a per-character bond timeline
writes session and profile data under ~/Documents/MuseAI/sends conversation context to your configured AI provider APIAI text adventure / TRPG (DM/GM mode)
one world book + multiple character cards, plus speech / action / plot inputs→AI-narrated scenes, character reactions and plot progression; adventure records can be archived into character memories and bond events
sends story context to your configured AI provider APIEnter-the-novel interactive mode
assembled outline + world book + character cards, with chosen entry point and playable identity→a playable story world with scene / beat / state / summary memory and saved progress that can be resumed later
sends story context to your configured AI provider APIWorld book & character card extraction + LAN mobile access
novel text or outlines; the desktop app running on your computer→AI-extracted structured world settings and character profiles; phone-browser access over the same WiFi without installing any app
sends uploaded novel text to the model API for extractionstarts a LAN service reachable by devices on the same WiFi
04Who is it for? When not to use it?
Good for
- DeepSeek Harness users who want a local AI companion / role-play experience while they work
- Players and creators who enjoy character cards, world books, AI TRPG sessions and immersive interactive fiction
- Novelists and worldbuilders preparing settings and characters for interactive stories
Not for
- MuseAI itself is free, but all AI features require your own API key and the provider bills per usage; some providers require a prepaid balance before calls work.
- Installers ship only for Windows (.exe) and macOS (.dmg); on Windows the README asks you to disable antivirus software during installation or the installer may be blocked.
05Compatibility, maintenance and safety notes
- MuseAI itself is free, but all AI features require your own API key and the provider bills per usage; some providers require a prepaid balance before calls work.
- Installers ship only for Windows (.exe) and macOS (.dmg); on Windows the README asks you to disable antivirus software during installation or the installer may be blocked.
- All data is stored locally under ~/Documents/MuseAI/ with no cloud sync; the README recommends backing up this directory regularly to avoid data loss.
No license declared · actively maintained (latest release v0.9.8, 2026-08-09)
06Frequently asked questions
How does MuseAI connect to DeepSeek Harness?
Through a dedicated DSH client plugin. The README announces dsh-museai-tavern (https://github.com/yejiming/dsh-museai-tavern), which installs MuseAI inside DeepSeek Harness so you can use DSH for work while adventuring with the AI.
Which AI models and providers does it support?
OpenAI, Anthropic (Claude), and any OpenAI-compatible service such as DeepSeek, Kimi, Zhipu and Qwen. You enter the API address, key and model name in Settings, and can assign different models and parameters to each module.
Where is my data stored?
Everything is saved locally under ~/Documents/MuseAI/ — works, reference library, outlines, character cards, world books, sessions and settings. Nothing is uploaded to external servers; only the context you actively send goes to your configured AI provider via API.
Does MuseAI cost anything?
MuseAI itself is completely free. AI costs are billed by your API provider based on actual usage (usually per token), and some providers require a prepaid balance.
Any platform-specific install caveats?
On macOS, if the app reports 'damaged and cannot be opened', run `xattr -dr com.apple.quarantine /Applications/MuseAI.app` in Terminal. On Windows, the README asks you to disable antivirus software before installing, then re-enable it afterwards.
07Related DSH workflows
openviking
by volcengine
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
colleague-skill
by titanwings
Turn memories and knowledge into warm, reusable agent skills — a skill generator for digital companions in the AI persona era.
archify
by tt-a1i
Agent skill for beautiful, verifiable architecture, workflow, sequence, data-flow, and lifecycle diagrams—self-contained HTML with motion and crisp export.
learn-harness-engineering
by walkinglabs
Harness engineering beginner tutorial, from 0 to 1
08Data and sources
重要更新：MuseAI 现在可以装进 DeepSeek Harness 新增 DSH 客户端插件 —— 把 MuseAI 装进 DeepSeek Harness 一边用 DSH 干活，一边与 AI 冒险！→ https://github.c…
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-21. Found an error? Submit a correction.