Metadata-Version: 2.4
Name: gigaloom
Version: 0.9.1
Summary: GigaLoom local, provider-neutral control plane for coding agents
Project-URL: Homepage, https://krakenalt.github.io/gigaloom/
Project-URL: Repository, https://github.com/krakenalt/gigaloom
Project-URL: Documentation, https://krakenalt.github.io/gigaloom/
Project-URL: Issues, https://github.com/krakenalt/gigaloom/issues
Project-URL: Changelog, https://github.com/krakenalt/gigaloom/blob/main/CHANGELOG_en.md
Author-email: Ruslan Yakupov <rusyak1999@gmail.com>
License-Expression: MIT
License-File: LICENSE
Requires-Python: <3.15,>=3.11
Requires-Dist: agent-client-protocol==0.11.1
Requires-Dist: anyio<5,>=4.10
Requires-Dist: cryptography<50,>=46
Requires-Dist: fastapi<1,>=0.133.0
Requires-Dist: pydantic<3,>=2.12.0
Requires-Dist: pyjwt[crypto]<3,>=2.12.0
Requires-Dist: python-dateutil<3,>=2.9.0
Requires-Dist: pyyaml<7,>=6.0
Requires-Dist: starlette<2,>=1.1
Requires-Dist: uvicorn<1,>=0.41.0
Provides-Extra: claude-sdk
Requires-Dist: claude-agent-sdk<0.3,>=0.2.122; extra == 'claude-sdk'
Provides-Extra: gpt2giga
Requires-Dist: gpt2giga<0.4.0,>=0.3.0; extra == 'gpt2giga'
Description-Content-Type: text/markdown

# GigaLoom

<!-- Release-version snippets in this file are generated by scripts/release.py. -->

[![Качество](https://img.shields.io/github/actions/workflow/status/krakenalt/gigaloom/ci.yaml?branch=main&style=flat-square&label=quality)](https://github.com/krakenalt/gigaloom/actions/workflows/ci.yaml)
[![Документация](https://img.shields.io/github/actions/workflow/status/krakenalt/gigaloom/docs-pages.yaml?branch=main&style=flat-square&label=docs)](https://github.com/krakenalt/gigaloom/actions/workflows/docs-pages.yaml)
[![PyPI](https://img.shields.io/pypi/v/gigaloom?style=flat-square&label=PyPI)](https://pypi.org/project/gigaloom/)
[![Python](https://img.shields.io/pypi/pyversions/gigaloom?style=flat-square)](https://pypi.org/project/gigaloom/)
[![npm](https://img.shields.io/npm/v/%40gigaloom%2Fweb?style=flat-square&label=npm)](https://www.npmjs.com/package/@gigaloom/web)
[![Лицензия](https://img.shields.io/github/license/krakenalt/gigaloom?style=flat-square)](LICENSE)
[![Покрытие](./badges/gigaloom-coverage.svg)](./docs/operations.md#quality-baseline)

GigaLoom — локальная панель управления для coding-агентов. Она запускает
нативные CLI и установленные ACP-агенты, связывает работу с проектами и
worktree, показывает подтверждения и результаты, а также может направить
поддержанный агент через локальный шлюз (gateway) `gpt2giga`.

## Установка и первый запуск

Нужны Python 3.11–3.14 и CLI хотя бы одного агента. Для управляемых терминалов
на macOS и Linux также нужен `tmux`; нативный запуск работает и без него.

```sh
uv tool install 'gigaloom==0.9.1'
giga doctor
giga ui
```

Откройте <http://127.0.0.1:8091/>. Интерфейс по умолчанию доступен только на
локальном компьютере.

## Нативный агент из терминала

Добавьте `giga` перед обычной командой агента. Аргументы, поток ввода-вывода и
код завершения остаются нативными:

```sh
giga codex exec --json "проверь этот репозиторий"
giga claude -p "проверь этот репозиторий"
giga gemini -p "проверь этот репозиторий"
giga pi
```

Авторизацией по-прежнему владеет CLI агента. Войдите в него обычным способом
до запуска через GigaLoom.

## Агент из ACP Registry

Сначала посмотрите план установки, затем подтвердите его:

```sh
giga agent search opencode --refresh --json
giga agent add opencode --dry-run --json
giga agent add opencode --yes --json
giga agent inspect opencode --json
```

GigaLoom устанавливает выбранный артефакт в собственный managed-каталог и не
меняет глобальный `PATH` или домашний конфиг агента. Если проверка показывает,
что агент работает только с нативным провайдером модели, его всё равно можно
запустить без выбора шлюза.

## ACP-агент через gpt2giga

Установите необязательную интеграцию:

```sh
uv tool install --force \
  --with 'gpt2giga>=0.3.0,<0.4.0' \
  'gigaloom[gpt2giga]==0.9.1'
```

Если `giga agent inspect opencode --json` подтверждает готовность маршрута,
выберите модель и запустите агент:

```sh
giga --with gpt2giga --model GigaChat-2-Max opencode
```

Модель должна присутствовать в `/models` шлюза. Если совместимость агента,
шлюза или модели не подтверждена, GigaLoom останавливает запуск до создания
процесса. Он не переключается незаметно на другой маршрут и не меняет
`~/.opencode`, `~/.codex`, `~/.claude` или `~/.gemini`.

Для Codex используется тот же способ выбора шлюза:

```sh
giga --with gpt2giga --model GigaChat-2-Max codex
```

Настройка авторизации, внешний шлюз и таблица поддерживаемых маршрутов описаны
в [руководстве по интеграции](./docs/gateway-integration.md).

## Куда идти дальше

| Задача | Руководство |
|---|---|
| Установить или обновить GigaLoom | [Установка](./docs/installation.md) |
| Пройти два первых сценария | [Быстрый старт](./docs/quickstart.md) |
| Найти, установить и проверить агента | [Агенты](./docs/agent-runtimes.md) |
| Подключить `gpt2giga` и выбрать модель | [Интеграция со шлюзом](./docs/gateway-integration.md) |
| Работать с проектами, тредами и Thread Relay | [Работа, треды и контекст](./docs/work-threads-and-context.md) |
| Сделать резервную копию и проверить локальный сервис | [Эксплуатация](./docs/operations.md) |
| Понять границы доступа и хранения данных | [Безопасность](./docs/security.md) |

Полная документация доступна
[на русском и английском](https://krakenalt.github.io/gigaloom/).

## Поддерживаемые системы

- macOS и Linux: нативные CLI, UI и управляемые терминалы с `tmux`;
- Windows: нативные CLI и UI; управляемый `tmux`-терминал недоступен;
- установка ACP-агентов требует поддержанного механизма сетевой изоляции,
  подробно описанного в [руководстве по агентам](./docs/agent-runtimes.md).

Базовый пакет не требует checkout исходников `gpt2giga`. Состояние GigaLoom
хранится локально в `~/.gigaloom` и проектных `.giga/`. Не добавляйте токены и
реальные `.env`-файлы в репозиторий.

## Разработка

```sh
npm --prefix web ci --ignore-scripts
npm --prefix web run build
./scripts/ci-base.sh sync
./scripts/ci-base.sh ruff-check
./scripts/ci-base.sh pytest tests/harness -q
```

Перед изменениями прочитайте [CONTRIBUTING.md](./CONTRIBUTING.md) и
[GOVERNANCE.md](./GOVERNANCE.md). Об ошибках сообщайте через
[GitHub Issues](https://github.com/krakenalt/gigaloom/issues), а об уязвимостях
— только по приватному каналу из [SECURITY.md](./SECURITY.md).

GigaLoom распространяется по [лицензии MIT](LICENSE).
