AI provider setup

The 🤖 AI action category (#156) is optional and off by default. ZettelFlow works fully with AI disabled — every other feature is deterministic and offline. When you opt in, you bring your own OpenAI-compatible provider; ZettelFlow ships no key and no default endpoint.

Turning it on

Settings → ZettelFlow → AI (optional):

1. Enable AI actions — off by default. While off, no AI action ever makes a network request.
2. Endpoint URL — the full OpenAI-compatible chat-completions URL. Examples:
3. OpenAI — https://api.openai.com/v1/chat/completions
4. OpenRouter — https://openrouter.ai/api/v1/chat/completions
5. LM Studio (local) — http://localhost:1234/v1/chat/completions
6. Ollama (local, OpenAI-compat) — http://localhost:11434/v1/chat/completions
7. Model — the model name your provider expects (e.g. gpt-4o-mini).
8. API key — your provider key. Stored in this vault's plugin data (.obsidian/plugins/zettelflow/data.json), sent only as a Bearer header to the endpoint above, and never logged.

Any of endpoint / model / key left blank means the provider is not usable, and AI actions no-op with a clear notice.

What is sent, and where

When you run an AI action, ZettelFlow sends the content of the note being built as the prompt to the single endpoint you configured — and nothing else. There is no telemetry, no bundled key, no default endpoint, and no second endpoint. See Capabilities & privacy.

The actions

The category ships three actions, each a thin wrapper over one completion call:

• Summarize — a short summary of the note.
• Classify — suggested topic tags.
• Generate questions — the open questions the note raises.

If a request fails (network error, bad config, malformed response), the action degrades to a clear notice and writes nothing — it never crashes the flow.

Provider-agnostic by design

ZettelFlow depends on no specific vendor: a single AiProvider interface (complete(prompt)) with one built-in OpenAI-compatible client (src/architecture/ai/). The OpenAI-compatible shape already covers OpenAI, OpenRouter, LM Studio and Ollama. Native SDKs, embeddings/RAG, streaming and agentic loops are intentionally out of scope.