HELP WITH THE MAC APP

Get back
to your work.

Installation, Canvas workflows, local models and cloud connections — start with the relevant guide or send a reproducible report.

Requirements and installation

The available desktop download is for Apple Silicon Macs. Open the DMG and drag OY.Surf into Applications. The app is free while in beta. Cloud provider usage is billed separately by the provider; Create → Video uses Seedance 2.5 through your fal key.

Local AI models download separately from the app. Available memory and disk space affect which models you can use and how quickly they run. Check Settings → AI for the models, their download sizes and readiness. You can browse your library before every model is downloaded.

Use a local copy of a file when a cloud-synced folder shows a placeholder. Screen recording, microphone and camera features need the corresponding macOS permissions.

Start here

• Install and open your first folder
• Canvas: references, connected steps, runs and saved results
• Save, import and export Recipes
• Connect OpenAI, fal or OpenRouter
• Local model downloads
• Keyboard shortcuts

If a workflow cannot run

1. Select the step and read the Inspector’s input and provider messages. Image-processing steps need an image input; prompt notes alone cannot feed a resize or cutout.
2. Check that the local model is ready or the selected cloud provider is connected. Cloud errors may require checking authentication, balance, endpoint access or rate limits in the provider’s dashboard.
3. Run the selected step first. Run a branch or the whole workflow after its inputs are correct. Stop pauses after the current operation finishes; it may not cancel a cloud request already accepted by the provider.

After an uncertain cloud response, check the provider’s request history before rerunning a paid operation. A local save or board-placement problem should not be treated as proof that the provider did not process the request.

If a board cannot save

Keep the board open and use its Retry action. Do not close the app until the save status clears. You can export a PNG for a visual copy, and save a Recipe for a reusable processing chain; a Recipe is not a full board backup.

All documentation · Privacy and data · Roadmap · Published app releases