Skip to content
BYOK Tools

SiYuan

Privacy-first block-based notes app with built-in AI on your key.

4.0 editor score•Notes & Knowledge•Free & open source; paid sync

Overview

SiYuan is a local-first, block-based personal knowledge management app with Markdown support. Its built-in AI assistant connects to OpenAI-compatible APIs using your own key.

  • Block references
  • Built-in AI writing
  • Local-first storage
  • Self-hosted server

Our verdict

What we like

  • Powerful PKM features
  • Data stays local

Watch out for

  • AI limited to OpenAI-compatible APIs

Works with these providers

Keys from these providers work in this app. Usage is billed by the provider at its list price.

BYOK Key Safety Score

Key handling in SiYuan

How we score
96/ 100

Grade A

Your key is stored on your device and requests go directly to the provider.

  • Key storage

    Key stays on your device; requests go direct to the provider.

    40/40
  • Auditable code

    Open source: anyone can verify how keys are handled.

    25/25
  • Self-hosting

    Can run entirely on your own infrastructure.

    15/15
  • Offline option

    Supports local models, so no key is needed at all for private work.

    10/10
  • Provider choice

    3 provider options, which lets you pick the provider whose data terms you trust.

    6/10

Whatever the score, give each app its own key, set a monthly spend limit with your provider, and revoke keys you no longer use. Read the key-safety checklist.

SiYuan FAQ

Does SiYuan support bring your own key?
Yes. SiYuan accepts your own API key from OpenAI, Azure OpenAI and OpenAI-compatible. Usage is billed by the provider at its API rates.
Where does SiYuan store my API key?
On your device. Requests go directly from SiYuan to the provider. Its BYOK Tools Key Safety Score is 96/100.
Is SiYuan free?
Open source: Free & open source; paid sync. API usage is billed separately by your model provider.
Is SiYuan open source?
Yes. The source code is at https://github.com/siyuan-note/siyuan. It can also be self-hosted.
Can SiYuan run local models?
Yes. It can connect to local runtimes such as Ollama or LM Studio, so no API key is needed for private or offline use.
Which platforms does SiYuan support?
macOS, Windows, Linux, iOS, Android, Self-hosted.

Community reviews

No reviews yet.