← Back to home
Comparison · Collab

Shiori vs SiYuan

A side-by-side editorial comparison of Shiori and SiYuan — release velocity, themes, recent moves, and the top alternatives to consider.

Shiori vs SiYuan: at a glance

FeatureShioriSiYuan
SectorCollabCollab
Velocity score0.06.3
Sparks · 30d01
Top themesbookmarks, self-hosted, api-first, golangnote-taking, mcp, semantic-search, local-first
Last editorial update4h ago1h ago
WebsiteVisit →Visit →

What is Shiori?

A Go bookmark manager rebuilding itself around an API — and only ever shipping release candidates.

Shiori is a self-hosted read-later and bookmark tool whose recent history is entirely release candidates: v1.7.0-rc.2, rc.3, v1.7.2-rc.1, v1.8.0-rc.1. The visible work has moved off the web UI and into an API v1 surface — tag endpoints, bookmark-tag association, filtering and counts — plus infrastructure like proxy-header authentication and SQLite performance. The last tagged release in this window is from July 2025.

Read the full Shiori trajectory →

What is SiYuan?

SiYuan opened a 3.8 branch and put AI agents, embeddings search and MCP in the first alpha.

The 3.7.4 alpha series ran as pure enhancement work with cumulative notes — each alpha restates the previous list and adds a line or two — covering mobile and HarmonyOS parity, database view refinements, drag-and-drop polish, and sync performance. The first 3.8 alpha breaks that pattern with a Feature block: secure OIDC authentication, an AI Agent, semantic search using embeddings and reranking, and Model Context Protocol support.

Read the full SiYuan trajectory →

Shiori vs SiYuan: editorial side-by-side

S
Shiori
COLLAB
0.0

A Go bookmark manager rebuilding itself around an API — and only ever shipping release candidates.

◆ Current state

Shiori is a self-hosted read-later and bookmark tool whose recent history is entirely release candidates: v1.7.0-rc.2, rc.3, v1.7.2-rc.1, v1.8.0-rc.1. The visible work has moved off the web UI and into an API v1 surface — tag endpoints, bookmark-tag association, filtering and counts — plus infrastructure like proxy-header authentication and SQLite performance. The last tagged release in this window is from July 2025.

◆ Where it's heading

The project is converting from a web app with an API bolted on into an API-first service with a client, and the login component, PWA and theme work are being rewritten around that split. Proxy forward-header authentication in particular is a deployment-shape decision: it assumes Shiori sits behind an authenticating reverse proxy rather than owning identity itself. The RC-only tagging pattern makes it hard to tell what the maintainers consider stable.

◆ Prediction

The next step is presumably a final v1.8.0 consolidating the API v1 tag work, though nothing in these entries indicates the RC-to-stable promotion is scheduled. If the pattern holds, the following RC continues on API endpoints rather than the UI.

S
SiYuan
COLLAB
6.3

SiYuan opened a 3.8 branch and put AI agents, embeddings search and MCP in the first alpha.

◆ Current state

The 3.7.4 alpha series ran as pure enhancement work with cumulative notes — each alpha restates the previous list and adds a line or two — covering mobile and HarmonyOS parity, database view refinements, drag-and-drop polish, and sync performance. The first 3.8 alpha breaks that pattern with a Feature block: secure OIDC authentication, an AI Agent, semantic search using embeddings and reranking, and Model Context Protocol support.

◆ Where it's heading

Two years of this changelog have been editor and database ergonomics for a local-first note tool. The 3.8 opening moves the product into retrieval and agent territory in one step, and pairs it with OIDC — which suggests the target is shared or self-hosted deployments, not just single-user vaults. The mobile and HarmonyOS work continues underneath.

◆ Prediction

Expect the 3.8 alpha series to spend several releases stabilising the embedding and MCP surface, with the practical questions — which models, local or remote, and what leaves the vault — resolved in later alphas rather than this one.

Alternatives to Shiori and SiYuan

Other Collab products tracked by Sparkpulse, ranked by recent ship velocity. Each card links to a full editorial trajectory and lets you pivot into a head-to-head comparison with either Shiori or SiYuan.

See all Shiori alternatives → · See all SiYuan alternatives →

Recent activity from Shiori and SiYuan

Latest ship moves from both products, interleaved chronologically. ⚡ = editorial spark.

  1. 1h agoSiYuanSiYuan v3.8.0-alpha.1
  2. 2d agoSiYuan3.7.4-alpha.6 adds tab dragging and child documents from selection
  3. 3d agoSiYuan3.7.4-alpha.5 adds S Pen hover and configurable tab startup
  4. 3d agoSiYuan3.7.4-alpha.4 improves Pandoc storage and mobile fonts
  5. 5d agoSiYuan3.7.4-alpha.3 improves sync performance and database toolbars
  6. 9d agoSiYuan3.7.4-alpha.2 improves opening rows from the relation selector
  7. 1y agoShioriAPI v1 gains tag endpoints, filtering and counts; proxy header auth
  8. 1y agoShioriSwagger UI disabled by default; session auth and Postgres fixes
  9. 2y agoShioriLight, dark and system theme selection in the web UI
  10. 2y agoShioriHome button clears the active search query

Frequently asked questions

What is the difference between Shiori and SiYuan?

They serve adjacent needs but don't currently overlap on shipped themes. SiYuan is currently shipping more aggressively (velocity 6.3 vs 0.0), with 1 editorial sparks in the last 30 days against 0. See the at-a-glance table above for a side-by-side breakdown of velocity, recent sparks, and editorial themes.

Is Shiori better than SiYuan?

Sparkpulse doesn't pick a winner — we score release velocity, not feature parity. SiYuan is currently shipping more aggressively (velocity 6.3 vs 0.0), with 1 editorial sparks in the last 30 days against 0. For your specific use case, the alternatives sections above list other Collab products to evaluate alongside.

What are the best alternatives to Shiori?

Top Shiori alternatives in Collab are ranked by recent ship velocity. Browse the "Shiori alternatives" section above for the current picks, or visit /alternatives/shiori for the full list with editorial commentary on each.

What are the best alternatives to SiYuan?

Top SiYuan alternatives in Collab are ranked by recent ship velocity. Browse the "SiYuan alternatives" section above for the current picks, or visit /alternatives/siyuan for the full list with editorial commentary on each.