Metadata-Version: 2.4
Name: agloop
Version: 0.7.0
Summary: Serverless Git & Markdown Multi-Agent Orchestration Framework for heterogeneous LLM agents (e.g. Claude <-> Gemini War Room)
Author: Yure Mark
License: MIT
Project-URL: Homepage, https://github.com/yuremarketing/AgLoop
Project-URL: Repository, https://github.com/yuremarketing/AgLoop
Project-URL: Issues, https://github.com/yuremarketing/AgLoop/issues
Keywords: agents,multi-agent,llm,orchestration,git,ai
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Version Control :: Git
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: GitPython>=3.1.43
Requires-Dist: python-dotenv>=1.0.1
Requires-Dist: litellm>=1.44.0
Provides-Extra: adk
Requires-Dist: google-adk>=0.1.0; extra == "adk"
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"
Dynamic: license-file

# AgLoop

**AgLoop** is a lightweight, Git-based orchestration framework for autonomous AI agents (like Claude and Gemini). It provides a robust, multi-agent loop system that relies on Git for process locking and Markdown for Inter-Process Communication (IPC).

## Core Concepts

- **Git-based Locking:** Uses standard `git push` and `git pull` as a reliable lock to manage agent concurrency across different machines or sessions.
- **Turn-based Execution:** Agents take "turns" executing work in an orchestrated manner, avoiding merge conflicts.
- **Markdown IPC:** The "War Room" (Sala de Guerra) approach where agents propose, debate, and agree on implementations via a single `.md` file.

*Originated from the Sysoft project.*

## Platform Support

Tested in CI on Linux, macOS and Windows (Python 3.10, 3.11, 3.12).

## Installation

```bash
pip install agloop
```

## Quick Start

Scaffold a clean `war_room.md` and governance templates in your repo:

```bash
agloop init
```

Run an agent loop (e.g. "Alice", a senior architect persona, debating with "Bob", a pragmatic developer persona):

```bash
agloop run --name Alice --model gemini/gemini-1.5-pro-latest
```

Other built-in commands:

```bash
agloop scan             # read-only scan of the repo structure
agloop audit --privacy  # LGPD-04 privacy diagnostic report
```

## Native Extensions & Plugins

Besides `pip install agloop`, the repo is natively installable inside the AI tools it orchestrates:

**Claude Code** (self-hosted plugin marketplace):
```bash
/plugin marketplace add yuremarketing/AgLoop
/plugin install agloop@agloop
```

**Gemini CLI** (direct extension install):
```bash
gemini extensions install https://github.com/yuremarketing/AgLoop
```

Both expose the same MCP server (`core/mcp_server.py`) and the War Room slash commands/hooks already shipped in `.claude-plugin/` and `gemini-extension.json`.
