wenlan README

README проекта с github.com/wenlan-app/wenlan. Одним файлом markdown: README.md.

Wenlan: the knowledge base you don't have to maintain. Free, open source, local-first.

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

CI Latest release License: Apache-2.0 and AGPL-3.0

Watch the Wenlan launch film (1:44)


Why Wenlan

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.

How it compares

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


Get started

1. Download and open Wenlan

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.

2. Bring in your material

Create a page, or bring in an Obsidian vault, a Logseq graph, a folder, or earlier AI chats. Import guide.

3. Connect your AI tool

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.


What you can bring in

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.


How it stays organized

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.

Illustrative flow: AI chats, documents and folders (including Obsidian), code, and web content go into Steep. It writes a new page from several memories, merges duplicate pages, and updates a page with a citation it checks against the source; a page set to Ask me first waits for approval. It also finds a new link and resolves a contradiction by keeping the newer statement, with the older one restorable from history. Next time you ask, your AI tool cites the updated page.

Illustration based on current update behavior; not an App screenshot.

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.


A wiki for your code repository

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.


For technical readers

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.

Architecture overview: App and AI tools share a local knowledge base, with optional background enrichment models.

Retrieval, evidence, and models.

Evaluation

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.


Data and privacy

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.


Learn more


Contributing

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.


Code signing policy

See the platform signing and notarization details.


License

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.


Lineage and peers

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.

wenlan (wenlan-app/wenlan)

Ищем в базе…

498 ·GitHub
Что это такое?Wenlan — это настольная студия с открытым исходным кодом, где ваши ИИ-инструменты собирают заметки, чаты и решения в страницы Markdown, навыки и правила, которые остаются актуальными. Работает как альтернатива Obsidian с вашим существующим хранилищем.
Это приложение, которое нужно установить, или библиотека, которую добавляют в код?Это настольное приложение для macOS, Windows и Linux. Рядом с ним работают локальный сервис, CLI и MCP-сервер, а пользоваться им вы будете напрямую, без импорта в проект.
Как это запустить?Скачайте настольное приложение для вашей системы и откройте его. В Настройках «Добавить инструмент» находит ваши ИИ-инструменты, а «Подключить все» настраивает их одним нажатием. Пользователи Mac могут также выполнить npx -y wenlan setup в терминале.
Можно ли доверять ссылкам на источники на страницах?Не слепо. Wenlan сверяет каждое процитированное предложение с его источником и отклоняет страницу, если большинство ссылок не совпадает, но прохождение этой проверки не доказывает, что страница верна.
Как это держит мои страницы в актуальном состоянии?Когда меняется источник, память или процитированный код, страницы, которые на них опираются, помечаются для обновления. Для любой страницы можно выбрать «Разрешено» или «Сначала спросить», посмотреть, что изменилось, и вернуть более ранню версию.
Что делает команда /wenlan?В вашем ИИ-инструменте введите /wenlan и опишите, что нужно: найти прошлые решения, сохранить урок или продолжить с того места, где вы остановились. Сокращения включают /recall, /capture, /handoff и /brief.
Почему автор создал это вместо того, чтобы использовать Obsidian?Для Obsidian нужны плагины, которые приходится искать, устанавливать и постоянно обновлять, а чтобы система заметок не приходила в упадок, требуется постоянный уход. Wenlan создан для тех, кто каждый день пользуется ИИ-инструментами и не хочет поддерживать систему заметок, и при этом по-прежнему работает с существующим хранилищем Obsidian.
Автор
wenlan-app
Размер
207.3 MB
Звёзды
498
Возраст
7 мес
Коммиты · 90 дней