Getting Started
From download to your first AI-enriched file — get Wikori running in under five minutes.
Requirements
| Item | Details |
|---|---|
| Operating System | macOS 11+, Windows 10/11, or Linux (Ubuntu 20+) |
| AI API endpoint | Any OpenAI-compatible endpoint — OpenAI, Anthropic, local Ollama, LM Studio, etc. |
| API key | A valid key for your chosen endpoint |
| Disk space | ~50 MB for the app; vault size depends on your content |
Wikori works with any OpenAI-compatible API. If you don't want to use a cloud service, Ollama running locally is a great free option.
Download & Install
Visit wikori.com and download the installer for your operating system.
macOS: Open the .dmg, drag Wikori to Applications. On first launch, right-click → Open to bypass Gatekeeper.
Windows: Run the .exe installer and follow the prompts.
Linux: Use the .AppImage (make it executable with chmod +x) or the .deb package.
Wikori opens to the Status page with an empty vault list. The app icon also appears in your system tray.
macOS Quick Notes hotkey: Wikori needs Accessibility permission to detect the global hotkey. Go to System Settings → Privacy & Security → Accessibility and add Wikori. The app will prompt you automatically on first use.
Create Your First Vault
A vault is a folder on your disk that Wikori monitors and enriches. You can have many — one per project, client, or topic.
Click Settings in the left sidebar.
In the Vaults section, fill in a Name (e.g. "Research"), optionally an Email Tag, and click Browse to choose a directory — or type a path. Then click Add Vault.
Inside your chosen directory, Wikori creates an INGEST/ subfolder. This is your drop zone. Any file placed here gets processed automatically.
Your new vault appears in the sidebar dropdown. Click it to make it active — all subsequent operations target this vault.
Set Up Your AI Provider
Wikori needs an AI endpoint to enrich your files. Configure it in Settings under the AI Provider section.
For OpenAI: https://api.openai.com/v1
For Ollama (local): http://localhost:11434/v1
For Anthropic or others, use their OpenAI-compatible base URL.
Paste your API key. It is encrypted with AES-256-GCM on save and never stored in plaintext.
Click Test Connection. If successful, available models load in the dropdown below.
Choose the model to use for enrichment. For best results use a capable chat model — gpt-4o, claude-3-5-sonnet, or similar.
Click Save Changes at the bottom of the page.
Process Your First File
Open your vault's directory in Finder or Explorer. Copy any PDF, Word document, image, or plain text file into the INGEST/ subfolder.
Switch to the Status page. Under the Queue section you'll see the file appear, then move through "processing" and finally disappear as it lands in your vault root.
Open the vault directory. You'll find a .md file with a YAML frontmatter block at the top containing title, summary, entities, tags, and more — all generated by your AI model.
Click Rebuild Wiki on the Status page to update the knowledge index and the interactive graph.
You can also drag files directly to the Ingest page in the app, paste URLs to scrape web pages, or type notes directly — all explained in the Ingesting Content guide.
System Tray
Wikori runs quietly in your system tray. Closing the main window doesn't quit the app — it keeps watching your vault in the background.
| Action | Result |
|---|---|
| Click tray icon | Restores the main window |
| Right-click → Open | Opens the Ingest page |
| Right-click → Settings | Opens Settings |
| Right-click → Quit | Fully exits the app |