Documentation

Guides for every feature — local-first, on-device, free.

Everything you need to get the most out of OY.Surf — how each feature works, what to click, and why. Use the search on the left, or start with Getting started.

Browse by topic

Getting started

• Getting started — Install OY.Surf and open your first folder.
• Library & folders — Quick folders, favorites, and how indexing works.

AI & creation

• Lenses — Palette, OCR, scenes and AI descriptions for any file.
• Search — Find by meaning, by text-in-image, and by filters.
• Create — generate images — Text-to-image and image-to-image, on-device or with your key.
• Edit images — Instruction editing with Qwen-Image-Edit, plus deterministic tools.
• Canvas & skills — A moodboard canvas with smart resize and slash-command skills.

Capture

• Surf Studio — screen recording — Record, edit on a multi-lane timeline, export MP4/GIF at pro speed.
• Surf Flow — voice dictation — Hold a key, talk, get cleaned text — transcribed on-device.
• Notes — Markdown notes pinned to your files and projects.

Models & privacy

• Models & downloads — What downloads, how big, and the Hugging Face token for speed.
• On-device vs cloud — Free and private by default; cloud is opt-in with your own key.
• Connecting API keys — Add your OpenRouter / OpenAI keys for optional cloud AI.

Integrations

• Figma integration — A local bridge so Figma and OY.Surf talk on your machine.
• MCP server & agent scenarios — Let AI agents search, curate and organize your library — locally, token-guarded.

Reference

• Settings — A tour of every Settings tab.
• Keyboard shortcuts — The keys that make OY.Surf fast.
• Privacy — What stays on your Mac (everything, by default).