MulmoClaude
English · 日本語 · 简体中文 · 한국어 · Español · Português (BR) · Français · Deutsch
📖 User guide: https://receptron.github.io/mulmoclaude/
🛠️ Setup guide for Mac (Japanese): https://receptron.github.io/mulmoclaude/setup/
An AI assistant that knows everything about you and supports you around the clock is not sold anywhere. You cannot buy one — you can only nurture one. MulmoClaude is a tool for nurturing your own AI assistant, on your own computer.
The substance of an assistant is not the AI model — the model is just the engine. What makes an assistant valuable is how much it knows about you: your conversations, your calendar, your notes, your data, and the apps you use. Something that important should not be entrusted to any single service provider — the longer you use it, the harder it becomes to leave. MulmoClaude is open source and runs locally, so everything your assistant accumulates — memories, data, apps — stays in your own hands, as plain files in your workspace.
Nurturing takes an environment, and MulmoClaude provides one: a place to accumulate memories (a personal wiki that Claude builds and maintains itself), a place to keep your data (schema-driven collections, feeds, plain files), and a place to build apps just for you — no programming knowledge required. You say "I want something like this" in everyday words, and Claude builds the small app you need: a restaurant list, an invoice tracker, vocabulary practice — software for an audience of one. Right after install the garden is empty; you plant seeds and tend the soil, and grow an assistant that is yours alone.
And the assistant is not tied to your desk. Log in from your phone — or a messaging app you already use — and you reach the same assistant living on your computer. The relay server only carries messages in transit — your memories, data, and apps never leave your computer.
Under the hood, MulmoClaude is an AI-native application platform: capabilities are plugins in a single registry (today: a full accounting system with real server-side bookkeeping logic, a personal wiki, an SEC-filings reader, and more), Claude acts as a universal controller that composes across them, and chat summons the right GUI for each task — markdown, charts, forms, wikis, spreadsheets, or 3D scenes.
How AI-Native Applications Should Be Built — the architecture, UX, and protocol thesis behind MulmoClaude.
📣 Updates
New releases and features are announced on X, in Japanese.
- Singularity Society (@SingularitySoci) — release and feature announcements
- Satoshi Nakajima (@snakajima) — MulmoClaude's owner
Quick Start
npx mulmoclaude@latest
The launcher boots the server and opens http://localhost:3001 in your browser. That's it — start chatting.
Keep it running: closing the terminal stops the server. To run in the background, launch inside
tmux/screen(macOS/Linux) or as a startup task (Windows Task Scheduler).
Start it from an icon (macOS / Windows)
To launch without opening a terminal, create an app bundle once:
npx mulmoclaude@latest create-shortcut
This writes MulmoClaude.app to /Applications (or ~/Applications if that is not writable — pass --dir <path> to choose, --yes to skip the prompt). Double-clicking it checks the prerequisites, shows a progress page while the server starts, and opens the app when it is ready. If the server is already running it just opens the browser rather than starting a second one.
When something is missing — Node.js, npx, or Claude Code — it says which one and what to run, in your system language. Its log is at ~/Library/Logs/MulmoClaude/launcher.log.
Where
.envgoes: a terminal launch reads.envfrom the directory you launched in. An icon has no such directory — macOS starts apps in/, and Windows starts them wherever the shortcut points — so the icon launch reads~/.env, your home directory.
On Windows the same command writes a shortcut to the Start Menu instead (--dir puts it elsewhere, e.g. the Desktop), with the launcher's own files under %LOCALAPPDATA%\MulmoClaude. It opens no console window. Everything else behaves identically.
Re-run the command after upgrading: the shortcut carries its own copy of the launcher.
Prerequisites
- Node.js 22.19+ — runtime
- Claude Code CLI — installed and authenticated. Run
claudeonce to complete OAuth - ffmpeg — required for movie generation. Skip if you don't generate videos
- macOS:
brew install ffmpeg - Linux:
apt install ffmpeg - Windows:
winget install Gyan.FFmpeg
- macOS:
- Docker Desktop (optional but recommended) — enables sandbox mode. See Installing Docker Desktop below
- whisper.cpp (optional, macOS only) — enables local voice input (dictate chat messages). See Optional: Local Voice Input below
UI language: 8 locales are supported (English, Japanese, Simplified Chinese, Korean, Spanish, Brazilian Portuguese, French, German). The default is auto-detected from the browser / OS language. To set it explicitly, put
VITE_LOCALE=ja(orzh/ko/es/pt-BR/fr/de) in.env. Locale is picked at build/dev time; restartyarn devafter changing it. Seedocs/developer.mdfor how to add strings.
Run from source (for developers)
To modify the code instead of just running it:
git clone git@github.com:receptron/mulmoclaude.git
cd mulmoclaude && yarn install
cp .env.example .env # optional — add GEMINI_API_KEY for image generation
yarn dev
Open http://localhost:5173. See docs/developer.md for architecture and scripts.
UI looks broken or unstyled? Icons showing as words,
dist/*404s,401after a restart — seedocs/troubleshooting.md.
What can you do?
| Ask Claude to... | What you get |
|---|---|
| "Write a project proposal" | Rich markdown document in the canvas |
| "Chart last quarter's revenue" | Interactive ECharts visualization |
| "Create a trip plan for Kyoto" | Illustrated guide with images |
| "Set up a todo list" | Schema-driven collection with a kanban board |
| "Ingest this article: URL" | Wiki page with [[links]] for long-term memory |
| "Schedule a daily news digest" | Recurring task that runs automatically |
| "Generate an image of a sunset" | AI-generated image (Gemini) |
| "Subscribe to this RSS feed" | Data feed on /feeds, fetched on a schedule |
| "What's new in my feeds?" | Feed items collected at /feeds |
Pages you can visit directly:
/wiki(browse + lint),/feeds(data feeds),/collections(data apps),/automations(recurring tasks),/files,/skills,/roles. Each has its own scoped chat composer that spawns a fresh chat already aware of the page context.
Hacking on MulmoClaude? See
docs/developer.mdfor environment variables, scripts, and architecture.
Messaging bridges
MulmoClaude can be accessed from messaging apps via bridge processes. Bridges run as separate child processes and connect to the server over socket.io.
# Interactive CLI bridge (same machine)
yarn cli
# Telegram bot bridge (requires TELEGRAM_BOT_TOKEN in .env)
yarn telegram
Bridges are also available as standalone npm packages:
# Chat platforms
npx @mulmobridge/cli@latest # CLI bridge
npx @mulmobridge/telegram@latest # Telegram bridge
npx @mulmobridge/slack@latest # Slack bridge
npx @mulmobridge/discord@latest # Discord bridge
npx @mulmobridge/line@latest # LINE bridge
npx @mulmobridge/whatsapp@latest # WhatsApp bridge
npx @mulmobridge/matrix@latest # Matrix bridge
npx @mulmobridge/irc@latest # IRC bridge
npx @mulmobridge/mattermost@latest # Mattermost bridge
npx @mulmobridge/zulip@latest # Zulip bridge
npx @mulmobridge/messenger@latest # Facebook Messenger bridge
npx @mulmobridge/google-chat@latest # Google Chat bridge
npx @mulmobridge/mastodon@latest # Mastodon bridge
npx @mulmobridge/bluesky@latest # Bluesky bridge
npx @mulmobridge/chatwork@latest # Chatwork bridge (Japanese business chat)
npx @mulmobridge/xmpp@latest # XMPP / Jabber bridge
npx @mulmobridge/rocketchat@latest # Rocket.Chat bridge
npx @mulmobridge/signal@latest # Signal bridge (via signal-cli-rest-api)
npx @mulmobridge/teams@latest # Microsoft Teams bridge (Bot Framework)
npx @mulmobridge/line-works@latest # LINE Works bridge (enterprise LINE)
npx @mulmobridge/nostr@latest # Nostr encrypted DM bridge
npx @mulmobridge/viber@latest # Viber bridge
# Universal / glue
n