Quickstart¶
KL4A is a native desktop app. Install it, open it, and everything else — creating a bundle, ingesting sources, reviewing mined knowledge, exporting, talking to the agent — happens inside the app itself. There's no CLI you need to touch to get started.
Get the app¶
| Platform | Download |
|---|---|
| Windows | ⬇ Installer (.exe) |
| macOS | ⬇ Disk image (.dmg) — universal, runs on Apple Silicon and Intel |
| Linux | ⬇ AppImage |
The builds aren't code-signed yet
No Apple Developer ID or Windows signing certificate is set up for this project yet, so your OS will warn you on first launch:
- macOS — Gatekeeper blocks it as "from an unidentified developer". Right-click
the app in Finder and choose Open (once), or run
xattr -cron it. - Windows — SmartScreen shows "Windows protected your PC". Click More info → Run anyway.
- Linux — mark the AppImage executable first:
chmod +x KL4A*.AppImage.
First launch¶
On first launch you land on the bundle picker. Create a new bundle, point it at a folder of SOPs/policies/procedures (Markdown, DOCX, or PDF), and the app walks you through the rest: ingest → inspect what got mined and why → review (approve, reject, defer, edit, comment) → export.
See the Desktop UI Guide for a full screen-by-screen tour.
A richer example¶
Once you're comfortable with the app, open the included GLP-1 Healthcare SOP reference bundle — a finished, evidence-linked bundle with persisted review states, conflict/freshness reporting, and full OKF/graph/RDF export:
Next steps¶
- Desktop UI Guide — the desktop app, screen by screen.
- MCP Server — connecting an agent to a bundle you've built.
- FAQ.md — common setup and ingestion problems.
- Contributing — if you want to work on KL4A itself.