RU
Download
Menu

Documentation

Installing, connecting models, SONNY and fixes for common problems.

Installing

There is no public installer yet. Today ORYVIO Alpha is installed by closed pilot participants.

When a build appears on the download page, check its checksum before running it.

shasum -a 256 ~/Downloads/ORYVIO_*.dmg
  1. Open the .dmg and drag ORYVIO into Applications.
  2. Launch ORYVIO. If macOS cannot verify the developer, open System Settings, then Privacy & Security, and click “Open Anyway”.
  3. On Windows run the ORYVIO_*.exe installer. If SmartScreen appears, click “More info” and “Run anyway” only after the SHA-256 matches.
Get-FileHash "$env:USERPROFILE\Downloads\ORYVIO_*.exe" -Algorithm SHA256

First launch

  1. Sign in to your ORYVIO account or sign up with an activation key. Passwords need at least 12 characters.
  2. Confirm your email from the message.
  3. Create your first project: it will hold chats, files and memory.
  4. Add an AI connection (see the next section).

If the app says the ORYVIO sign-in service is not configured in this build, it is a test build without the account service. Use the pilot build.

Connecting models

Open Connections, click Connect AI and pick a type. The key is saved to the system vault.

  1. Timeweb AI Gateway: create an AI Gateway key in the Timeweb Cloud panel, paste it, address https://api.timeweb.ai/v1.
  2. OpenAI API: a key from platform.openai.com, address https://api.openai.com/v1. Access follows OpenAI's rules for your country.
  3. Compatible service: an address like https://server/v1 and a key if it needs one.
  4. Ollama: install Ollama, pull a model, address http://127.0.0.1:11434/v1, no key needed.

After saving, click Refresh models. The list comes from the connection's API.

Setting up SONNY

SONNY on Hermes is not yet enabled in user builds. This section describes how it will work.

  1. SONNY uses the same AI connection as the chat. The agent needs no separate key.
  2. For each project you grant the folders the agent may work with.
  3. Risky actions (commands, writes, browser) are approved one by one.
  4. The Stop button ends the turn and the model request.

Projects and memory

  1. A new chat is created inside a project and sees its memory.
  2. You add memory entries by hand or confirm them from the Pending suggestions.
  3. The Project / Shared switch decides which memory an entry belongs to.
  4. Every entry can be edited, its versions viewed or deleted.

Troubleshooting

  1. Error 401 or 403: the key is wrong or lacks access to the model. Check it in the provider's panel.
  2. Error 429: a provider limit was hit. Wait; ORYVIO never retries a paid request by itself.
  3. A model is missing: it is not in the connection's catalogue or is not a chat model. Click Refresh models.
  4. Ollama does not answer: start Ollama and check the model is pulled.
  5. macOS says the app is damaged: check the SHA-256, then remove the quarantine flag with the command below.
xattr -dr com.apple.quarantine /Applications/ORYVIO.app