AI Features
OikoNotes uses AI to enhance your note-taking with automatic transcription, OCR, content analysis, semantic search, and per-note chat. All AI features are optional and require configuration.
Supported Providers
| Provider | Audio | OCR | Image | Chat | Embeddings |
|---|---|---|---|---|---|
| Mistral | ✓ | ✓ | ✓ | ✓ | ✓ |
| OpenAI | ✓ | ✓ | |||
| Anthropic | ✓ | ||||
| Ollama | ✓ | ✓ |
Mistral is the default and most fully featured provider. Ollama runs entirely on your own hardware and needs no API key.
Configuration
Configure your AI provider in Settings → AI Provider:
- Choose your provider (Mistral, OpenAI, Anthropic, or Ollama)
- Enter your API key (stored encrypted in the vault) — not needed for Ollama
- Select models for each capability: audio transcription, OCR, image analysis, chat, text analysis, and embeddings
- Use "Discover Models" to refresh available models from your provider
- For Ollama, set your custom endpoint URL
Audio Transcription
Audio files (recorded or uploaded) are automatically transcribed to text. The transcription becomes the note content, with the original audio preserved as an attachment.
OCR (Optical Character Recognition)
Images and documents are processed with OCR to extract text. Useful for capturing text from photos, scanned documents, or screenshots.
Content Analysis
AI analyses note content and generates structured suggestions:
- Title and tag suggestions
- Wikilink suggestions to existing notes
- Split proposals for multi-topic notes
- Follow-up questions to expand the note
- Entity extraction (dates, people, locations, amounts, organisations)
- Detected tasks, events, and shopping items
- Note type routing suggestions
- Template suggestions with reformatted content
- Kanban card suggestions for project work
Per-Note Chat
Each note has a chat section where you can have a conversation with AI about the note's content. The AI responds with context from the note. Chat history is saved across sessions.
Semantic Search
AI generates vector embeddings for each note, enabling semantic search — finding notes by meaning rather than exact keywords.
Human-in-the-Loop
All AI suggestions require explicit user approval. Nothing is applied automatically. You review suggestions in the Process Queue or editor sidebar and choose to apply or reject each one.
Per-Note AI Toggle
Each note has an AI toggle in the editor. Disable it to prevent AI from processing a specific note.
Background Processing
AI jobs run in the background. When you capture a note, the AI worker queues analysis automatically. Jobs include retry logic with exponential backoff for rate limits or temporary failures.