项目的 README,来自 github.com/wenlan-app/wenlan。合并为一个 markdown 文件:README.md。
Open-source Obsidian alternative that works with your existing vault.
Your AI tools keep it organized and up to date, with no API keys or plugins. For you and your team.
English | 简体中文 | 繁體中文 | Español
Download · Get started · Sources · Docs · Discord
I started Wenlan because my notes, documents, and AI chats were scattered, and keeping a note system from rotting took constant upkeep. Since then we keep hearing the same about Obsidian: too much setup, with plugins to find, install, and keep updated. Wenlan is for people who use AI tools every day and don't want to maintain a note system.
Personal: download the desktop app and use it on your own.
Teams (in the next release): a self-hosted Wenlan server everyone connects to, with view-only or edit access for each person.
| Obsidian + plugins | Notion | LLM wiki apps | Wenlan | |
|---|---|---|---|---|
| Who organizes | You, with plugins | You, or Notion's agents | An AI you set up | Your AI tools; updates when a source changes |
| Setup | Find and update plugins | Full AI on the Business plan | Model key or scheduled routine | One click, no API key |
| Checks the AI's work | Depends on the plugin | Cites sources; no match check | Links to sources | Refuses pages whose citations don't match |
| What AI may change | Depends on the plugin | Pages you give an agent | Its wiki folder | You choose per page; restore anytime |
| Where notes live | Your computer | Notion's cloud | Your computer | Your computer; works with your vault |
Download the desktop app for macOS 11 or later on Apple Silicon, Windows x64, or Linux x64 (AppImage or .deb, from v0.22). The app is in English, 简体中文, and 繁體中文.
Prefer the terminal? On a Mac, run npx -y wenlan setup, or brew install 7xuanlu/tap/wenlan and then wenlan setup. Linux and Windows: CLI install guide.
Create a page, or bring in an Obsidian vault, a Logseq graph, a folder, or earlier AI chats. Import guide.
In the App's Settings, Add a tool finds the AI tools on your computer and Connect all sets them up in one press. There is nothing else to install or keep updated. Then start a new AI session and ask:
/wenlan what did I decide about this before? Then help me: …
/wenlan ($wenlan in Codex) is the one command to remember: say what you want after it.
Works with Claude Code, Claude Desktop, Codex, Cursor, GitHub Copilot, VS Code, Gemini CLI, Windsurf, Grok Bot, and other MCP tools. Set one up by hand.
When an import finishes, the app offers Write pages with your AI tool to turn it into your first cited pages. No command needed.
/wenlan wiki writes pages tied to the code. Code wiki.You can also connect an Open Knowledge Format (OKF) folder as a source. Scanned PDFs need text extraction first; chat attachments are not imported. Import guide.
Your AI tool reads what you bring in and writes it into Markdown pages. It links related pages, cites where each sentence came from, and brings pages up to date when a source changes. You can open any page and write in it yourself.
Illustration based on current update behavior; not an App screenshot.
[n], Wenlan compares each cited sentence with its source and refuses the page when most citations don't match. Passing the check does not prove a page correct.[[links]] that point to no page yet./wenlan and say what you want: look up earlier decisions, save a lesson, or pick up where you stopped. Shortcuts: /recall, /capture, /handoff, /brief. Plugin commands.Already using Claude Code or Codex on a folder of notes? Keep doing that. Wenlan connects to the same tool and adds what a folder can't do alone: citation checks, flags when sources change, and per-page control over what AI may change.
Run /wenlan wiki ($wenlan wiki in Codex) in a repository. Your AI tool writes an overview and one page for each part or flow a newcomer needs. A rerun writes only the pages that are missing.
wiki/ folder as a pull request, when you press it or daily. The daily run uses your own AI tool on your computer, or GitHub Actions with your AI tool's key saved as a repository secret. The same pull request fixes sentences in the repository's docs that the code no longer agrees with.One local knowledge base. The app, CLI, and connected AI tools read and write through Wenlan’s local service. Pages are Markdown files; memories, relationships, and search indexes live in local libSQL. The service, CLI, and MCP server are written in Rust; the desktop app uses Tauri with React and TypeScript.
Retrieval, evidence, and models.
These LongMemEval (LME) snapshots measure retrieval of saved knowledge, not AI answer quality. Recall@5 measures how much relevant material appears in the top five results.
| Benchmark | Recall@5 | MRR | NDCG@10 |
|---|---|---|---|
| LME_Oracle (500 Q) | 93.6% | 0.857 | 0.883 |
| LME_S (deep, 90 Q) | 87.7% | 0.815 | 0.822 |
On a 10,000-page test (generated pages, M2 Pro with 16 GB, v0.20.0), App search answered in 11 to 50 ms, restart took under 0.3 s, and memory peaked at about 1.2 GB. With the search fix in 0.20.1, AI-tool search found all 30 rare test words in that library.
Importing a 10,000-note Obsidian vault in 0.20.2 (invented notes, M2 Pro Mac with 16 GB, debug build, Claude Code writing the pages): searchable in 15 s, the first page in about 2 minutes, and 8 cited pages in about 4 minutes.
Evaluation method and benchmark details.
Web access (experimental): Turn on Web access in Settings to let web AI clients such as Claude, ChatGPT, or Muse search your library or a chosen Space while your computer is online. When you allow an app, choose search only or search and write; a write app can also add, edit and delete, and AI apps can ask you before each change. Queries and results pass through a relay. See the privacy limits.
File locations, backup, and removal · Network and privacy details.
Join the Discord community. Report bugs or request features in GitHub issues; issues are public, so redact secrets and personal information.
For code and docs, see Contributing, Security, and the Code of Conduct.
See the platform signing and notarization details.
The local runtime, CLI, MCP server, shared types, and plugins use Apache-2.0. The desktop app and its frontend use AGPL-3.0-only; modified versions run as a network service must offer their source to users.
Wenlan takes its name from Wenlan Pavilion. Its direction builds on the LLM-wiki and agent-memory lineages: Karpathy’s LLM-wiki note, Rohitg00’s proposal, and nashsu/llm_wiki.