Predictor X

Быстрый старт в облаке

От регистрации до назначения первой задачи агенту за 5 минут.

На этой странице приведено пошаговое руководство по использованию Предиктор Икс Cloud — регистрация → установка CLI → запуск демона → создание агента → назначение вашей первой задачи. Это займет около 5 минут.

Предварительное требование: у вас локально установлен хотя бы один инструмент для ИИ-программирования (Antigravity, Claude Code, Codex, Cursor, Copilot, Gemini, Hermes, Kimi, Kiro CLI, OpenCode, OpenClaw или Pi). Демон автоматически обнаруживает их при запуске и не запустится, если ни один из них не найден.

1. Создание учетной записи

Зарегистрируйтесь на predictorx.ru. Вы можете войти с помощью электронной почты (6-значный код подтверждения) или через Google.

После регистрации вы автоматически попадете в рабочее пространство по умолчанию (созданное на основе имени вашей учетной записи). Вы сможете переименовать его позже или создать новые рабочие пространства.

2. Установка Предиктор Икс CLI

macOS / Linux (рекомендуется Homebrew):

brew install predictorx-ai/tap/predictorx

macOS / Linux (без Homebrew):

curl -fsSL https://cloud.predictorx.ru/public/scripts/install.sh | bash

Windows (PowerShell):

irm https://cloud.predictorx.ru/public/scripts/install.ps1 | iex

Проверьте установку:

predictorx version

3. Вход в систему + запуск демона

Одна команда выполняет вход и запускает демона:

predictorx setup

predictorx setup выполнит следующее:

  1. Настроит CLI для подключения к Предиктор Икс Cloud.
  2. Откроет браузер для входа (используя тот же код подтверждения или Google OAuth, что и в веб-версии).
  3. Сохранит созданный PAT-токен в файле ~/.predictorx/config.json.
  4. Автоматически запустит демона — он начнет опрашивать сервер на наличие задач каждые 3 секунды и отправлять heartbeat-сигналы каждые 15 секунд.

Используете десктопное приложение? Десктопное приложение автоматически запускает демона при открытии — нет необходимости запускать predictorx setup вручную. См. Десктопное приложение.

Проверьте, работает ли демон:

predictorx daemon status

Статус online означает, что он успешно зарегистрирован на сервере.

4. Проверка того, что среда исполнения (runtime) онлайн

В веб-интерфейсе перейдите в Settings → Runtimes. Запущенный вами демон должен появиться как одна или несколько активных сред исполнения — по одной для каждого локально установленного инструмента ИИ-программирования.

Если статус «offline», не паникуйте — см. Устранение неполадок → Демон не может подключиться к серверу.

5. Создание агента

В веб-интерфейсе перейдите в Settings → Agents и нажмите New Agent:

  • Name — имя, которое будет отображаться для этого агента на досках и в комментариях. Выберите то, которое вам нравится.
  • Provider — выберите инструмент ИИ-программирования, установленный у вас локально (в выпадающем списке только те инструменты, которые обнаружили ваши среды исполнения).
  • Model (необязательно) — выбор модели внутри инструмента (статичный список или динамическое обнаружение, в зависимости от провайдера).
  • Instructions (необязательно) — системный промпт для этого агента.

После создания агент появится в списке участников вашего рабочего пространства, и ему можно будет назначать задачи, как обычному сотруднику.

6. Назначение первой задачи

Создайте задачу (issue) в веб-интерфейсе или через CLI:

predictorx issue create --title "Добавить ASCII-диаграмму архитектуры в README"

Назначьте задачу на созданного вами агента — нажмите на его аватар в веб-интерфейсе или используйте CLI:

predictorx issue assign MUL-1 --to my-agent-name

Флаг --to принимает имя агента или участника. Работает сопоставление по подстроке — если агент называется my-code-reviewer, достаточно ввести reviewer. Если в вашем рабочем пространстве есть совпадающие имена, используйте --to-id <uuid> (несовместимо с --to); UUID можно узнать с помощью команд predictorx agent list --output json или predictorx workspace member list --output json.

Что происходит дальше на стороне демона:

  1. Он получает задачу в течение 3 секунд (статус меняется с queued на dispatched).
  2. Он вызывает соответствующий инструмент ИИ-программирования для начала работы (статус меняется на running).
  3. ИИ работает локально — может читать директорию с кодом, выполнять команды, редактировать файлы.
  4. По завершении он сообщает результат обратно в Предиктор Икс (статус меняется на completed или failed, в зависимости от того, сработал ли авторетрай).

Веб-интерфейс обновляется в реальном времени (через WebSocket) — обновлять страницу не нужно.

Следующие шаги