Metadata-Version: 2.4
Name: gigaloom
Version: 0.8.0
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.3.0,>=0.2.6; extra == 'gpt2giga'
Description-Content-Type: text/markdown

# GigaLoom

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

[![Quality](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)
[![Documentation](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)
[![License](https://img.shields.io/github/license/krakenalt/gigaloom?style=flat-square)](LICENSE)
[![GigaLoom coverage baseline](./badges/gigaloom-coverage.svg)](./docs/operations.md#quality-baseline)

GigaLoom is a local, provider-neutral control plane for coding agents. It
combines provider-native `giga <agent>` commands and a browser cockpit for governed
sessions, approvals, worktrees, schedules, evaluations, and multi-agent
workflows.

GigaLoom 0.8 builds on the first stable 0.7 release with native-agent profiles,
an ACP registry, reviewed app installation, and deterministic headless
execution. It keeps user state local, redacts sensitive values at storage and
UI boundaries, and fails closed when an action needs authority that has not
been granted.

Use it to:

- run Codex, Claude, Gemini, Pi, and compatible agents behind one local control
  plane without replacing their native CLIs;
- isolate work in project-bound worktrees while retaining approvals, receipts,
  evaluations, and replayable evidence;
- add reviewed MCP apps and ACP agents through digest-bound installation plans;
- automate headless runs through a deterministic JSONL contract and optional
  adapters without granting ambient credentials or workspace authority.

## Install

Python 3.11–3.14 and an installed provider CLI are required. Managed provider
terminals additionally use `tmux` on Linux and macOS; systems without it keep
provider-native passthrough.

```sh
uv tool install 'gigaloom==0.8.0'
giga doctor
giga --version
```

Start the browser cockpit:

```sh
giga ui
```

Then open `http://127.0.0.1:8091/`. Prefix native provider commands without
changing their remaining arguments:

```sh
giga codex exec --json "review this repository"
giga claude -p "review this repository"
giga gemini -p "review this repository"
giga pi
```

See [Installation](./docs/installation.md) and
[Quickstart](./docs/quickstart.md) for the complete first-run flow.

## Documentation

| Topic | Guide |
|---|---|
| Product overview | [Documentation home](./docs/index.md) |
| Installation, upgrades, and first run | [Installation](./docs/installation.md) · [Quickstart](./docs/quickstart.md) |
| Architecture and safety boundaries | [Architecture](./docs/architecture.md) · [Durability and performance](./docs/architecture/durability-performance-contracts.md) · [Security](./docs/security.md) |
| Runtime, backup, and troubleshooting | [Operations](./docs/operations.md) |
| Optional gpt2giga gateway | [Gateway integration](./docs/gateway-integration.md) |
| npm Web assets | [Web package](./web/README.md) |
| Development, tags, and release recovery | [Contributing](./docs/contributing.md) · [Release](./docs/release.md) |
| Repository migration | [Source history](./docs/source-history.md) |

The published English and Russian documentation is at
<https://krakenalt.github.io/gigaloom/>.

## Gateway integration

The base `gigaloom` distribution is independently installable and does
not require a gateway source checkout. Direct Chat and the legacy local-gateway
preset are optional:

```sh
uv tool install 'gigaloom[gpt2giga]==0.8.0'
```

The optional extra consumes the released `gpt2giga` distribution. Its
normalized protocol and compatibility contracts remain owned by the
[gpt2giga gateway project](https://github.com/ai-forever/gpt2giga); see the
[integration guide](./docs/gateway-integration.md) for canonical links.

## Development

```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
```

Build the standalone distribution with:

```sh
uv build --no-sources
```

Read [CONTRIBUTING.md](./CONTRIBUTING.md) before submitting changes and
[GOVERNANCE.md](./GOVERNANCE.md) for ownership and recovery rules. Report bugs
through [GitHub Issues](https://github.com/krakenalt/gigaloom/issues), but send
suspected vulnerabilities through the private channel in
[SECURITY.md](./SECURITY.md).

## Source history

GigaLoom was extracted from the combined `ai-forever/gpt2giga` repository.
Links to that repository in older changelog entries and migration notes are
historical source references, not current development locations. Current
development, issues, documentation, and releases belong to
`krakenalt/gigaloom`.

Licensed under the [MIT License](LICENSE).
