Перейти к содержанию

Быстрый старт

Требования

  • Python 3.11.9+
  • Git
  • PowerShell на Windows или Bash на Linux/macOS

Опционально:

  • uv для bootstrap-потока на Windows
  • приватные submodule, если вы работаете ещё и с клиентом, backend или infra-репозиториями

Клонирование

git clone -b rev2026 https://github.com/stipot-com/adaos.git
cd adaos

Опциональные submodule:

git submodule update --init --recursive \
  src/adaos/integrations/adaos-client \
  src/adaos/integrations/adaos-backend \
  src/adaos/integrations/infra-inimatic \
  src/adaos/integrations/rasa-port

rasa-port is optional but recommended when working on NLU locally. If it is absent, AdaOS installs adaos-rasa-nlu for the Rasa service-skill from https://github.com/stipot-com/rasa-port.git.

Bootstrap

Linux / macOS

bash tools/bootstrap.sh
source .venv/bin/activate
# bash tools/bootstrap.sh --zone ru --dev

Windows PowerShell через uv

powershell -ExecutionPolicy Bypass -File tools/bootstrap_uv.ps1
.\.venv\Scripts\Activate.ps1
# powershell -ExecutionPolicy Bypass -File tools/bootstrap_uv.ps1 -ZoneId ru -Dev

Windows PowerShell через pip

powershell -ExecutionPolicy Bypass -File tools/bootstrap.ps1
.\.venv\Scripts\Activate.ps1
# powershell -ExecutionPolicy Bypass -File tools/bootstrap.ps1 -ZoneId ru -Dev

Bootstrap-скрипты поддерживают zonal Root routing через --zone или -ZoneId. Используем только двухбуквенный код страны или региона, например ru. Это влияет на adaos dev root init, adaos dev root login, member join по join-code и создание join-code на hub, если используется стандартный публичный Root URL. Для национальных зон действует правило [zone].api.inimatic.com; сейчас это актуально для ru, поэтому будет выбран https://ru.api.inimatic.com, а остальные зоны пока остаются на https://api.inimatic.com. Дополнительно флаг --dev / -Dev записывает ENV_TYPE=dev в .env.

Ручная editable-установка

pip install -e ".[dev]"

Первые команды

adaos --help
adaos where
adaos api serve --host 127.0.0.1 --port 8777

Заметки по локальным портам:

  • 8777 — порт по умолчанию для прямого development runtime.
  • 8778 — второй slot в supervisor-managed режиме.
  • Если нужно, чтобы browser app не auto-discover локальный runtime и остался на Root, запускайте API на другом порту, например 8779:
adaos api serve --host 127.0.0.1 --port 8779
  • Если --port передан явно, AdaOS сохраняет этот локальный адрес в .adaos/node.yaml как local_api_url.
  • Следующие adaos api serve без явного --port используют сохранённый local_api_url.
  • adaos api serve поднимает runtime напрямую и не включает supervisor-managed slot cutover.

Во втором терминале:

curl -i http://127.0.0.1:8777/health/live
curl -i http://127.0.0.1:8777/health/ready

Типовые локальные действия

Установить стандартный локальный контент:

adaos install
adaos update

adaos install prepares the optional Rasa NLU service-skill and trains it once by default. Use adaos install --no-rasa-nlu on nodes that should use regex/neural NLU only, or adaos install --no-train-nlu when you want to train later.

Проверить локальные объекты:

adaos skill list
adaos scenario list
adaos node status --json

Запустить тесты:

pytest