siyuan
An open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间,让人与智能体在此协作
⭐ 45,805 stars on GitHub · 🍴 2,950 forks · 📜 License: agpl-3.0 · 💻 Language: TypeScript
What is siyuan?
Finding a local-first knowledge base that handles both massive text documents and granular data queries usually means compromising on mobile access or privacy. SiYuan solves this by combining block-level bi-directional linking with a self-
Topics: the project is tagged with popular topics:
- 🏷️
agentic-ai - 🏷️
ai-agent - 🏷️
digital-garden - 🏷️
electron - 🏷️
knowledge-base - 🏷️
knowledge-graph - 🏷️
local-first - 🏷️
markdown - 🏷️
mcp - 🏷️
note-taking
📸 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
| Component | Recommended |
|---|---|
| RAM | 2048 MB |
| CPU | 2 vCPU |
| Disk | 25 GB SSD |
| OS | Ubuntu 22.04 LTS / Debian 12 |
| Docker | 24.0+ |
⚡ 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 -ddeploy 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 15/08/2026. Star/fork counts may have changed — see live numbers via the GitHub link.
