Articles · Getting started
Installing and setting up Kition (macOS / Windows)
From download to opening your first vault and wiring up your first model — done in five minutes.
Download and install
Pick your platform at kition.ai/download: macOS (Universal .dmg — Intel + Apple Silicon), Windows (.exe), Linux (.AppImage). The download is 120-180MB; double-click to install.
On first macOS launch you may see "developer not verified" — go to Settings → Privacy & Security and click "Open anyway." (Notarization is in flight.)
Create your first vault
On first launch Kition asks you to pick a vault folder. You can create a new empty folder or point it at an existing Obsidian export. A vault is just a normal directory — your .md documents and a .kition/ config folder live in it.
Configure a model provider
In Settings → AI Providers add at least one: paste an API key and pick the wire type (anthropic_messages for Claude, responses for GPT). Save.
Quick smoke test
- ⌘N to create a doc — confirm live preview renders
- ⌘K to open the command palette — search "agent"
- Ask the agent to "list files in vault" — confirm filesystem tools work
Related reading
Getting started
What is Kition? A 5-minute product tour
Kition combines connected Markdown documents, structured data tables, browser research, visual workflows, and a real AI agent.
Getting started
How to create your first vault
A vault is Kition’s unit of work. It is just a folder on your machine — no proprietary format, leave anytime.
Getting started
Wire your first AI model: OpenAI / Anthropic
One table on wire types, real configs for three providers, and a checklist for auth failures.