Build your local second brain — AI-powered, your data stays yours.
English · 中文 · 🌐 Official Website
Molio is a local-first desktop application that unifies knowledge management, AI writing, and content publishing. Open your existing Obsidian vault, write with Claude Code / Codex / Gemini in a beautiful graphical interface, and publish to 30+ platforms — all your data stays on your machine, never touching third-party servers.
| Feature | Description |
|---|---|
| 🗂️ Obsidian-Compatible | Point Molio at your existing Obsidian vault — zero migration, pure Markdown, no vendor lock-in |
| 🤖 Multi-Agent + Local-First | Use Claude Code, Codex, Gemini CLI, Qwen Code in a unified GUI with streaming output — all data stays on your machine, never touching third-party servers |
| ✂️ Web Clipper | Chrome extension clips web pages to your vault with one click, auto-opens the desktop app. Chrome Web Store | Other Browsers |
| 📝 Editor → Publish | Split-pane Markdown editor with real-time preview, typesetting powered by doocs/md, one-click publishing to 30+ platforms via doocs/cose |
| 💬 Messaging Integration | Mobile chat with your knowledge base via WeChat (regional integration) |
| 📖 Knowledge Graph | Visual browsing of your knowledge connections and relationships |
A single Molio instance can serve multiple channels in parallel. Most channels can be onboarded right from the Web console.
| Channel | Text | Image | File | Voice | Group |
|---|---|---|---|---|---|
| Web Console (default) | ✅ | ✅ | ✅ | ✅ | — |
| ✅ | ✅ | ✅ | ⏳ | ⏳ | |
| Feishu | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ |
| Telegram | ⏳ | ⏳ | ⏳ | ⏳ | ⏳ |
| Slack | ⏳ | ⏳ | ⏳ | — | ⏳ |
| Discord | ⏳ | ⏳ | ⏳ | — | ⏳ |
✅ Supported · ⏳ Planned · — N/A
AI Chat: Multi-agent support with streaming responses |
Knowledge Base: Vault file tree with Markdown rendering |
Editor: Split-pane with real-time preview |
Publishing: One-click sync to 30+ platforms |
Download the latest release from GitHub Releases:
- Windows:
Molio-Setup-x.x.x.exe - macOS:
Molio-x.x.x.dmg
Install and launch. On first run, you'll be guided to configure an AI runtime CLI (e.g., Claude Code, Codex, Gemini).
If you want to build from source or contribute to development:
Prerequisites:
- Node.js >= 22
- pnpm >= 9
- At least one AI runtime CLI:
# Clone the repository
git clone https://github.com/zhuzhaoyun/Molio.git
cd Molio
# Install dependencies
pnpm install
# Start development environment (daemon + web)
pnpm dev
# Or start individually
pnpm dev:daemon # Backend only (port 3100)
pnpm dev:web # Frontend only (port 5173)Desktop Build:
# One-click build + generate unpacked version
pnpm desktop:run
# Or full packaging as installer
pnpm package
# Generate unpacked directory only (no installer)
pnpm package:dirTesting:
pnpm test # Run all tests (node:test)
pnpm typecheck # Type checking
pnpm build # Build all packages
pnpm test:e2e # E2E tests (requires pnpm dev running)Molio/
├── packages/
│ └── contracts/ @molio/contracts — Shared type definitions
├── apps/
│ ├── daemon/ @molio/daemon — Hono HTTP server (API + SSE)
│ ├── web/ @molio/web — Vite + React frontend
│ └── desktop/ @molio/desktop — Electron desktop shell
└── package.json Monorepo root config
Tech Stack:
- Frontend: React 19 + Vite 6 + TypeScript
- Backend: Hono + Node.js + SQLite (better-sqlite3)
- Desktop: Electron 40 + electron-builder
- Build: pnpm workspace monorepo
Contributions are welcome! Please see CONTRIBUTING.md for guidelines.
Key principles:
- All changes must go through Pull Request (no direct pushes to
main) - Follow Conventional Commits:
feat(scope): description - Add tests for bug fixes (unit tests for daemon/desktop, E2E for web)
- Run smoke tests before submitting PRs
Molio is inspired and supported by these excellent open-source projects:
- multica — Open-source Agent management platform, inspiring Molio's multi-runtime orchestration
- doocs/md — WeChat Markdown editor, powering Molio's typesetting engine
- doocs/cose — Multi-platform content distribution extension, powering Molio's publishing capabilities
- WeKnora — Tencent's open-source knowledge management platform, providing design philosophy reference
Thanks to the authors and communities of these projects!
File an issue on GitHub, or scan the QR code below to join our WeChat community:
Modified Apache 2.0 — Based on Apache License 2.0 with additional commercial use restrictions. Free for internal and non-commercial use; commercial hosting/embedding requires a commercial license.
If you find Molio useful, consider giving it a ⭐️ star on GitHub!