siyuan

An open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间，让人与智能体在此协作

⭐ 46,813 stars on GitHub · 🍴 3,071 forks · 📜 License: agpl-3.0 · 💻 Language: TypeScript

What is siyuan?

A self-hosted notes & knowledge management tool. Your data lives on your server — no vendor lock-in, no risk of provider shutdown.

Main components

• Content block
• Block-level reference and two-way links
• Custom attributes
• SQL query embed
• Protocol siyuan://
• Block-style
• Markdown WYSIWYG
• List outline

The biggest strength is no vendor lock-in — markdown/JSON data, easy to migrate between tools.

Best for researchers, devs, product people — anyone wanting a portable second brain across devices.

Topics: the project is tagged with popular topics:

• 🏷️ agentic-ai
• 🏷️ ai-agent
• 🏷️ knowledge-base
• 🏷️ local-first
• 🏷️ markdown
• 🏷️ mcp
• 🏷️ note-taking
• 🏷️ self-hosted
• 🏷️ siyuan

📸 Screenshots

Quick install

The project ships a ready-to-use docker-compose.yml — get running in 3 commands:

git clone https://github.com/siyuan-note/siyuan.git
cd siyuan
docker compose up -d

Minimum system requirements

⚡ Deploy fast on VSIS

Use the VSIS VPS Lite 2GB RAM / 2 vCPU / 25GB SSD (~104k/tháng) plan from VSIS.NET — high-speed VN-based VPS, 24/7 support, ideal for running siyuan smoothly.

🎯 Benefits:

• One-command docker compose up -d deploy in 2 minutes
• Dedicated IPv4, root access, unmetered domestic bandwidth
• Daily snapshot backup
• Free install assistance from the VSIS team

👉 See matching VPS plans at vsis.net

Resources

• 🔗 GitHub: siyuan-note/siyuan
• 🌐 Homepage: https://b3log.org/siyuan
• 📚 Official docs: see README in the repo
• 💬 Community: GitHub Issues + Discussions

Article compiled from GitHub data on 17/10/2026. Star/fork counts may have changed — see live numbers via the GitHub link.