Установка
GigaLoom 0.7 — первый стабильный релиз Native Agent Gateway, основанный на ломающем clean cut 0.6. Поддерживается Python 3.11–3.14. Отдельно установите хотя бы один provider-native CLI и завершите собственный flow аутентификации провайдера.
Для managed provider terminals также нужны POSIX-система и доступный tmux с
корректным выводом tmux -V. На Linux или macOS установите tmux через
системный package manager. Windows и POSIX-системы без рабочего tmux
сохраняют provider-native passthrough; GigaLoom не подменяет его собственным
эмулированным terminal UI.
Установка GigaLoom
Через uv:
uv tool install 'gigaloom==0.9.1'
Или в изолированном Python-окружении:
python -m pip install 'gigaloom==0.9.1'
Проверьте установленный артефакт:
giga --version
giga doctor
doctor сообщает состояние возможностей и конфигурации, не читая содержимое
prompts и не обращаясь к провайдерам.
Обновление до 0.8
Точное ограничение uv tool install остаётся закреплённым при
uv tool upgrade. Для перехода с предыдущего prerelease пересоздайте tool
environment с новой точной версией:
uv tool install --force 'gigaloom==0.9.1'
Если использовался optional gateway extra, сохраните его явно:
uv tool install --force 'gigaloom[gpt2giga]==0.9.1'
Перед обновлением остановите все процессы GigaLoom и сохраните
~/.gigaloom, исторический root ~/.gpt2giga/harness, если он существует, и
.giga/ каждого зарегистрированного проекта.
Миграция namespace и команд
Имя PyPI-проекта изменилось до первого самостоятельного target release.
Удалите исторический дистрибутив и установите gigaloom, не удаляя
существующие каталоги состояния:
uv tool uninstall gpt2giga-harness
uv tool install 'gigaloom==0.9.1'
Обновите extensions, imports, scripts и frontend consumers как единый clean cut:
| Историческая поверхность | Поверхность 0.6 |
|---|---|
PyPI gpt2giga-harness | PyPI gigaloom |
Python gpt2giga_harness.* | Python gigaloom.* |
команда gpt2giga-harness | команда giga |
entry-point group gpt2giga.harnesses | gigaloom.harness_adapters.v1 |
npm @gpt2giga/harness-cockpit-v2 | npm @gigaloom/web |
top-level UI aliases, например /work и /workflows | canonical routes /web/** |
Внешние adapters должны быть перевыпущены для новой entry-point group; runtime bridge для старой group отсутствует. Standalone-дистрибутив не публикует legacy Python namespace, команду, entry-point group, npm package или Web route aliases.
Миграция локального состояния
Перед первым запуском 0.6 остановите существующие Harness-процессы, уберите
устаревший override GPT2GIGA_HARNESS_DATA_DIR и выполните:
giga state migrate --json
Тот же preflight автоматически запускается перед обычными командами с default
root. Old-only state сначала сохраняется в проверенный backup под
~/.gigaloom-migration, затем переносится через staging и атомарно публикуется
в ~/.gigaloom. Legacy root и все project .giga/ остаются нетронутыми. Если
оба root уже существуют без завершённого migration journal, GigaLoom
останавливается и печатает явные команды mv, не выбирая authoritative root
самостоятельно. giga state rollback восстанавливает проверенный backup в
legacy root и сохраняет ~/.gigaloom для диагностики.
Для собственного canonical root задайте GIGALOOM_DATA_DIR. При таком
override default roots автоматически не мигрируются.
Обновление состояния 0.6 для Native Agent Gateway
Изменение state 0.6→0.7 выполняется отдельной явной offline-миграцией. Остановите Web server, workers, native sessions и все остальные процессы, использующие data directory, затем выберите путь backup вне этого каталога:
giga state upgrade --backup ../gigaloom-before-0.7.zip --json
Команда сначала создаёт и проверяет полный state archive, затем в фиксированном
порядке выполняет project_catalog_v1 и
textual_preferences_retirement_v1. Legacy project bindings у sessions
становятся catalog bindings. Старые Textual-only preferences исключаются, а не
копируются в browser preferences. Project repositories, .giga/, provider
homes, credentials, prompts и provider output не читаются и не меняются.
Миграция возобновляется после каждой durable boundary и сохраняет content-free
receipt в migrations/ активного state. Сохраняйте archive и соседний private
migration support directory вместе до приёмки candidate. Повтор команды с тем
же backup path возвращает тот же проверенный receipt.
Для recovery остановите GigaLoom и атомарно восстановите pre-upgrade archive:
giga state verify ../gigaloom-before-0.7.zip --json
giga state restore ../gigaloom-before-0.7.zip --replace --json
Восстановите archive до переустановки 0.6. Reverse schema migration и объединение старого и нового state tree не поддерживаются.
Откат обновления
До миграции state остановите GigaLoom и переустановите точную предыдущую версию. Если миграция уже началась, сначала оставьте 0.6 установленным и восстановите проверенный backup:
giga state rollback
uv tool install --force --prerelease allow 'gigaloom==0.5.1a2'
giga state rollback восстанавливает исторический root из
~/.gigaloom-migration и сохраняет ~/.gigaloom для диагностики. Не
направляйте старый executable на canonical root 0.6, не объединяйте два root
вручную и не удаляйте их до проверки rollback. Project .giga/ и
provider-owned homes эта команда не мигрирует и не откатывает.
Downgrade пакета отделён от rollback релиза: опубликованные registry versions
и их теги v... неизменяемы, их нельзя перезаписывать или перемещать.
Необязательный gateway preset
Базовый пакет не требует gpt2giga. Установите extra только для Direct Chat или legacy preset локального gateway:
uv tool install 'gigaloom[gpt2giga]==0.9.1'
Устанавливается поддерживаемый стабильный диапазон gateway; committed lock для разработки и release разрешает точный публичный artifact. Репозиторий gateway, sibling checkout, editable dependency или submodule не нужны. См. Интеграцию с gateway.
Использование Web package без Python
Сервис, самостоятельно публикующий проверенные static Cockpit assets, может установить соответствующий npm release:
npm install --save-exact @gigaloom/web@0.9.1
Смонтируйте dist/ package по /web/assets/ и обслуживайте
dist/index.html для operator routes. Сохраняйте hashed filenames и проверяйте
вложенный content manifest. Это не React component library и не Python server;
Python wheel содержит те же Web bytes.
Удаление
uv tool uninstall gigaloom
Удаление пакета не удаляет пользовательское состояние в
~/.gigaloom. Сначала прочитайте Операции.