# siyuan-note/siyuan

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

Repository: https://github.com/siyuan-note/siyuan
Canonical: https://ross.abutalabs.com/products/siyuan
Homepage: https://b3log.org/siyuan
Language: TypeScript
License: AGPL-3.0
License Family: copyleft
Topics: note-taking, local-first, knowledge-base, markdown, s3, pdf, webdav, self-hosted, notes-app, electron, siyuan, pkm, notebook, wiki, knowledge-graph, digital-garden, ai-agent, mcp, agentic-ai
Last push: 2026-08-26T16:28:55+00:00

## Health v2 (maintenance only)
Score: 95/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 86, longevity 100
- inputs: {"age_days": 2194, "days_push": 7, "days_rel": 15, "gap_med": 8.0, "n_releases_24m": 63}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 45994, forks 2963 (observed 2026-08-28T04:12:09.711058+00:00)

## What it is
SiYuan is a privacy-first, local-first note-taking and personal knowledge management application built around block-level editing, bidirectional links, and Markdown. It supports self-hosted deployment via Docker, end-to-end encrypted sync through S3/WebDAV, and AI agent collaboration including MCP integration.

## Use cases
- take notes with block-level editing and backlinks
- build a personal knowledge base with a knowledge graph
- self-host a private note-taking app with Docker
- sync notes across devices with end-to-end encryption
- use flashcards and spaced repetition for studying
- connect AI agents to my notes via MCP
- manage large documents with Markdown and WYSIWYG editing

## When to choose
- you want a privacy-first, local-first alternative to Notion or Obsidian
- you need block-level editing with bidirectional links and backlinks
- you want to self-host your notes and sync via your own S3/WebDAV storage
- you want built-in flashcards, databases, and AI assistance in one workspace

## When to avoid
- you need real-time collaborative editing like Google Docs
- you require a fully free official cloud sync service
- you only need a plain lightweight Markdown text editor

## Facets
- artifact type: application
- maturity: active
- function: markdown, editor, mcp, self-hosted, search-engine, data-visualization
- domain: developer-tools, productivity, privacy, self-hosted
- platform: cross-platform, self-hosted, windows
- tags: note-taking, pkm, block-editor, backlinks, knowledge-graph, local-first, e2e-encryption, spaced-repetition, flashcards, wysiwyg, ai-agents, sync, knowledge-management, desktop, electron, docker, macos, linux, mobile

## Member repositories
- siyuan-note/siyuan (main) score 95

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:12:09.711058+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T16:21:37.895279+00:00, confidence not recorded.
  - readme: https://github.com/siyuan-note/siyuan (fetched 2026-08-28T04:12:09.711058+00:00, sha 0cc5a551ba77)
  - homepage: https://b3log.org/siyuan (fetched 2026-08-29T07:45:18.818812+00:00, sha 2df3c6b18dd3)
  - site_page: https://b3log.org/siyuan/pricing.html (fetched 2026-08-29T07:45:18.828047+00:00, sha 41c38cf1c6f9)
- Data as of 2026-08-30T08:39:29.467469+00:00.