Metadata-Version: 2.4
Name: ralph-workflow
Version: 0.8.21
Summary: Autopilot for coding agents — run Claude Code, Codex, OpenCode, Nanocoder, AGY & Pi unattended with verification, recovery, orchestration.
Project-URL: Homepage, https://ralphworkflow.com
Project-URL: Documentation, https://ralphworkflow.com/docs
Project-URL: Repository, https://codeberg.org/RalphWorkflow/Ralph-Workflow
Project-URL: Issues, https://codeberg.org/RalphWorkflow/Ralph-Workflow/issues/new
Project-URL: Community, https://codeberg.org/RalphWorkflow/Ralph-Workflow/issues
Project-URL: GitHub Mirror, https://github.com/Ralph-Workflow/Ralph-Workflow
Project-URL: Changelog, https://codeberg.org/RalphWorkflow/Ralph-Workflow/src/branch/main/ralph-workflow/CHANGELOG.md
Author: Mistlight
Maintainer: Mistlight
License: AGPL-3.0-or-later
License-File: LICENSE
Keywords: agent,ai,autonomous-coding,coding-agent,loop,orchestration,unattended
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
Classifier: Natural Language :: English
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Code Generators
Requires-Python: >=3.12
Requires-Dist: ddgs>=9.14.0
Requires-Dist: gitpython>=3.1
Requires-Dist: httpx>=0.27
Requires-Dist: jinja2>=3.1
Requires-Dist: loguru>=0.7
Requires-Dist: mcp>=1.27.0
Requires-Dist: psutil>=5.9
Requires-Dist: pydantic>=2.7
Requires-Dist: readability-lxml>=0.8.1
Requires-Dist: rich-click>=1.8
Requires-Dist: rich>=13.0
Requires-Dist: selectolax>=0.3.21
Requires-Dist: sentry-sdk>=2.0
Requires-Dist: tqdm>=4.66
Requires-Dist: typer>=0.12
Requires-Dist: watchdog>=4.0
Provides-Extra: bundle
Requires-Dist: pyinstaller>=6.0; extra == 'bundle'
Provides-Extra: dev
Requires-Dist: hatch; extra == 'dev'
Requires-Dist: hypothesis>=6.100; extra == 'dev'
Requires-Dist: mypy; extra == 'dev'
Requires-Dist: pydantic>=2.7; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest-cov>=4.0; extra == 'dev'
Requires-Dist: pytest-xdist>=3.6; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: readability-lxml>=0.8.1; extra == 'dev'
Requires-Dist: ruff; extra == 'dev'
Requires-Dist: selectolax>=0.3.21; extra == 'dev'
Requires-Dist: types-psutil>=5.9; extra == 'dev'
Requires-Dist: vulture>=2.16; extra == 'dev'
Provides-Extra: docs
Requires-Dist: linkify-it-py>=2; extra == 'docs'
Requires-Dist: myst-parser; extra == 'docs'
Requires-Dist: sphinx-copybutton>=0.5; extra == 'docs'
Requires-Dist: sphinx-design>=0.5; extra == 'docs'
Requires-Dist: sphinx>=7; extra == 'docs'
Provides-Extra: web-search
Requires-Dist: brave-search-python-client>=0.4.27; extra == 'web-search'
Requires-Dist: exa-py>=2.12.0; extra == 'web-search'
Requires-Dist: tavily-python>=0.7.23; extra == 'web-search'
Description-Content-Type: text/markdown

# ralph-workflow

> **Codeberg is primary:** <https://codeberg.org/RalphWorkflow/Ralph-Workflow>
> GitHub is a read-only mirror:
> <https://github.com/Ralph-Workflow/Ralph-Workflow> (verify: repo-exists)

> **Autopilot for coding agents** — run Claude Code, Codex, OpenCode,
> Nanocoder, AGY & Pi unattended with verification, recovery,
> orchestration.

This README is the PyPI-facing surface. The canonical product
positioning, who-it-is-for list, install steps, first-run path, trust
and safety boundaries, and finish-receipt example all live in the
[repository root `README.md`](https://codeberg.org/RalphWorkflow/Ralph-Workflow/src/branch/main/README.md).
That page is the single source of truth; PyPI readers should follow
the link above for the install → init → diagnose → spec → run → review
walkthrough.

## At a glance

- **Python:** `>=3.12`
- **License:** AGPL-3.0-or-later
- **Runtime:** local-first; no required cloud account
- **Auth:** your agent CLIs authenticate as they always do — Ralph Workflow does not store, read, or proxy credentials

## Install and prove the install

```bash
pipx install ralph-workflow
ralph --version
ralph --diagnose     # optional pre-flight check
```

## Supported agents

| Agent | Notes |
|---|---|
| **Claude Code** | Anthropic's CLI for Claude (interactive + headless). Canonical reference agent. |
| **Codex** | OpenAI's Codex CLI. |
| **OpenCode** | Open-source terminal coding agent. |
| **Nanocoder** | Local-only TUI coding agent. |
| **Google Anti Gravity (AGY)** | Google's Antigravity CLI (`agy`, v1.0.9+). |
| **Pi** | Minimal coding agent. Headless mode is `pi --mode json <prompt>`. |

## Where to go next

- [Repository root `README.md`](https://codeberg.org/RalphWorkflow/Ralph-Workflow/src/branch/main/README.md) —
  canonical product positioning and first-run path
- [`START_HERE.md`](https://codeberg.org/RalphWorkflow/Ralph-Workflow/src/branch/main/START_HERE.md) —
  guided first run on one real backlog task
- [Operator manual (`docs/sphinx/index.rst`)](https://codeberg.org/RalphWorkflow/Ralph-Workflow/src/branch/main/ralph-workflow/docs/sphinx/index.rst) —
  maintained reference, configuration, troubleshooting, API reference
- [`CONTRIBUTING.md`](https://codeberg.org/RalphWorkflow/Ralph-Workflow/src/branch/main/CONTRIBUTING.md) —
  contribution intent and source-of-truth ordering
- [Package-side `CONTRIBUTING.md`](https://codeberg.org/RalphWorkflow/Ralph-Workflow/src/branch/main/ralph-workflow/CONTRIBUTING.md) —
  Python-specific dev build, policy-driven pipeline, guardrails
- [Issue tracker](https://codeberg.org/RalphWorkflow/Ralph-Workflow/issues/new)