Документация

Установка, подключение моделей, SONNY и решения частых проблем.

Установка

Публичного установщика пока нет. Сейчас ORYVIO Alpha устанавливают участники закрытого пилота.

Когда сборка появится на странице загрузки, проверь контрольную сумму перед запуском.

shasum -a 256 ~/Downloads/ORYVIO_*.dmg
  1. Открой .dmg и перетащи ORYVIO в папку «Программы».
  2. Запусти ORYVIO. Если macOS не может проверить разработчика, открой Системные настройки, затем Конфиденциальность и безопасность, и нажми «Всё равно открыть».
  3. На Windows запусти установщик ORYVIO_*.exe. Если появится SmartScreen, нажми «Подробнее» и «Выполнить в любом случае» только после сверки SHA-256.
Get-FileHash "$env:USERPROFILE\Downloads\ORYVIO_*.exe" -Algorithm SHA256

Первый запуск

  1. Войди в аккаунт ORYVIO или зарегистрируйся по ключу активации. Пароль: не короче 12 символов.
  2. Подтверди email по письму.
  3. Создай первый проект: в нём будут чаты, файлы и память.
  4. Добавь ИИ-подключение (см. следующий раздел).

Если приложение пишет «Сервис входа ORYVIO не настроен в этой сборке», это тестовая сборка без сервиса аккаунтов. Возьми сборку из пилота.

Подключение моделей

Открой «Подключения», нажми «Подключить AI» и выбери тип. Ключ сохраняется в системном хранилище.

  1. Timeweb AI Gateway: создай ключ AI Gateway в панели Timeweb Cloud, вставь его, адрес https://api.timeweb.ai/v1.
  2. OpenAI API: ключ с platform.openai.com, адрес https://api.openai.com/v1. Доступ определяют правила OpenAI для твоей страны.
  3. Совместимый сервис: адрес вида https://сервер/v1 и ключ, если он нужен.
  4. Ollama: установи Ollama, скачай модель, адрес http://127.0.0.1:11434/v1, ключ не нужен.

После сохранения нажми «Обновить модели». Список придёт из API подключения.

Настройка SONNY

SONNY на базе Hermes пока не включён в сборки для пользователей. Этот раздел описывает, как он будет устроен.

  1. SONNY использует то же ИИ-подключение, что и чат. Отдельный ключ для агента не нужен.
  2. Для каждого проекта ты выдаёшь папки, с которыми агенту можно работать.
  3. Опасные действия (команды, запись, браузер) подтверждаются по одному.
  4. Кнопка «Стоп» прерывает ход и запрос к модели.

Проекты и память

  1. Новый чат создаётся внутри проекта и видит его память.
  2. Запись в память добавляешь вручную или подтверждаешь из предложений «На рассмотрении».
  3. Переключатель «Проект / Общая» выбирает, к какой памяти относится запись.
  4. Каждую запись можно изменить, посмотреть версии или удалить.

Устранение неполадок

  1. Ошибка 401 или 403: ключ неверный или у него нет доступа к модели. Проверь ключ в панели провайдера.
  2. Ошибка 429: превышен лимит провайдера. Подожди, ORYVIO сам платный запрос не повторяет.
  3. Модели нет в списке: её нет в каталоге подключения или она не чатовая. Нажми «Обновить модели».
  4. Ollama не отвечает: запусти Ollama и проверь, что модель скачана.
  5. macOS пишет, что приложение повреждено: сверь SHA-256, затем сними карантинную метку командой ниже.
xattr -dr com.apple.quarantine /Applications/ORYVIO.app