Перейти к основному содержимому

Установка

Что это​

raytsystem ставится из исходного чекаута репозитория. На сегодня это единственный поддерживаемый способ установки: standalone-шаблон рабочего пространства и готовые релизные артефакты пока отложены (docs/STATUS.md, раздел «Known gaps»). Проект разворачивается локально и не требует ни API-ключа, ни облачного аккаунта, ни браузерного расширения.

Предварительные условия​

  • Python 3.12+ (репозиторий ограничивает диапазон >=3.12,<3.15, см. pyproject.toml).
  • uv — менеджер окружения и запуска.
  • Node.js 22+ нужен только для пересборки фронтенда. В обычной установке готовый бандл интерфейса уже лежит в репозитории, поэтому Node не требуется.

Подробнее о требованиях — на странице Требования.

Пошагово​

  1. Склонируйте репозиторий и перейдите в каталог:

    git clone https://github.com/romarayt/raytsystem-public-os.git raytsystem
    cd raytsystem

  2. Установите зависимости (включая dev-инструменты) через uv:

    uv sync --dev

  3. Проверьте окружение и канонические указатели, не меняя проект:

    uv run raytsystem doctor

  4. Запустите loopback-only интерфейс:

    uv run raytsystem start

Команды взяты из блока «Canonical development commands» в docs/STATUS.md и раздела «Open the interface» в README.md.

Ожидаемый результат​

uv run raytsystem doctor печатает сводку окружения: версию Python, версию SQLite и набор проверок (checks). Установка считается корректной, когда команда завершается со статусом healthy (в JSON-режиме поле "healthy": true). Если проверка не проходит, doctor возвращает ненулевой код выхода и указывает, какой пункт не прошёл.

Ограничения и безопасность​

  • Поддерживается установка из исходного GitHub-чекаута; хостовые инсталляторы пока не распространяются.
  • Интерфейс запускается исключительно на локальном loopback 127.0.0.1 — привязка к внешнему адресу отклоняется (src/raytsystem/cli.py).
  • Установка ничего не выполняет во внешних системах: рантайм-исполнение и провайдерские адаптеры по умолчанию выключены.

Частые ошибки​

  • Web bundle is missing при попытке открыть интерфейс — бандл фронтенда отсутствует. См. Интерфейс не запускается.
  • doctor не healthy — разберитесь по пунктам checks. См. Ошибки doctor.
  • Неподдерживаемая версия Python — проверка python_supported требует Python 3.12+.

Связанные страницы​

Источники истины​

  • README.md
  • docs/STATUS.md
  • pyproject.toml
  • src/raytsystem/cli.py