Metadata-Version: 2.4
Name: mellona-hive
Version: 2.3.2
Summary: CLI-first orchestration platform for autonomous agents with Git-backed task, run, and memory state
Project-URL: Homepage, https://github.com/intertwine/hive-orchestrator
Project-URL: Documentation, https://github.com/intertwine/hive-orchestrator/blob/main/docs/START_HERE.md
Project-URL: Repository, https://github.com/intertwine/hive-orchestrator
Project-URL: Issues, https://github.com/intertwine/hive-orchestrator/issues
Project-URL: Changelog, https://github.com/intertwine/hive-orchestrator/releases
Author: Bryan Young, Agent Hive Community
License: MIT
License-File: LICENSE
Keywords: agents,ai,automation,llm,orchestration
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.11
Requires-Dist: python-dotenv<2.0.0,>=1.2.1
Requires-Dist: python-frontmatter<2.0.0,>=1.1.0
Requires-Dist: pyyaml<7.0.0,>=6.0.3
Requires-Dist: requests<3.0.0,>=2.32.5
Provides-Extra: all
Requires-Dist: claude-code-sdk<1.0.0,>=0.0.25; extra == 'all'
Requires-Dist: daytona<1.0.0,>=0.152.0; extra == 'all'
Requires-Dist: e2b<3.0.0,>=2.2.5; extra == 'all'
Requires-Dist: fastapi<1.0.0,>=0.115.0; extra == 'all'
Requires-Dist: fastembed<1.0.0,>=0.5.0; extra == 'all'
Requires-Dist: lancedb<1.0.0,>=0.20.0; extra == 'all'
Requires-Dist: mcp~=1.22.0; extra == 'all'
Requires-Dist: uvicorn<1.0.0,>=0.32.0; extra == 'all'
Requires-Dist: weave<1.0.0,>=0.51.0; extra == 'all'
Provides-Extra: console
Requires-Dist: fastapi<1.0.0,>=0.115.0; extra == 'console'
Requires-Dist: uvicorn<1.0.0,>=0.32.0; extra == 'console'
Provides-Extra: coordinator
Requires-Dist: fastapi<1.0.0,>=0.115.0; extra == 'coordinator'
Requires-Dist: uvicorn<1.0.0,>=0.32.0; extra == 'coordinator'
Provides-Extra: dashboard
Requires-Dist: fastapi<1.0.0,>=0.115.0; extra == 'dashboard'
Requires-Dist: uvicorn<1.0.0,>=0.32.0; extra == 'dashboard'
Provides-Extra: dev
Requires-Dist: black<26.0.0,>=25.11.0; extra == 'dev'
Requires-Dist: build<2.0.0,>=1.3.0; extra == 'dev'
Requires-Dist: claude-code-sdk<1.0.0,>=0.0.25; extra == 'dev'
Requires-Dist: fastapi<1.0.0,>=0.115.0; extra == 'dev'
Requires-Dist: httpx<1.0.0,>=0.28.0; extra == 'dev'
Requires-Dist: mcp~=1.22.0; extra == 'dev'
Requires-Dist: pylint<5.0.0,>=4.0.3; extra == 'dev'
Requires-Dist: pytest-asyncio<0.27.0,>=0.24.0; extra == 'dev'
Requires-Dist: pytest<9.0.0,>=8.2.0; extra == 'dev'
Requires-Dist: twine<7.0.0,>=6.2.0; extra == 'dev'
Requires-Dist: uvicorn<1.0.0,>=0.32.0; extra == 'dev'
Requires-Dist: weave<1.0.0,>=0.51.0; extra == 'dev'
Provides-Extra: drivers-claude
Requires-Dist: claude-code-sdk<1.0.0,>=0.0.25; extra == 'drivers-claude'
Provides-Extra: mcp
Requires-Dist: mcp~=1.22.0; extra == 'mcp'
Provides-Extra: retrieval
Requires-Dist: fastembed<1.0.0,>=0.5.0; extra == 'retrieval'
Requires-Dist: lancedb<1.0.0,>=0.20.0; extra == 'retrieval'
Provides-Extra: sandbox-daytona
Requires-Dist: daytona<1.0.0,>=0.152.0; extra == 'sandbox-daytona'
Provides-Extra: sandbox-e2b
Requires-Dist: e2b<3.0.0,>=2.2.5; extra == 'sandbox-e2b'
Provides-Extra: tracing
Requires-Dist: weave<1.0.0,>=0.51.0; extra == 'tracing'
Description-Content-Type: text/markdown

# Agent Hive

Agent Hive is a repo-native control plane for autonomous work. Use Codex, Claude Code, or local/manual execution to
do the work. Use Hive to supervise tasks, runs, memory, policy, and approvals from one place.

**Keep your agent. Add a control plane.**

`mellona-hive` is the distribution you install from PyPI or Homebrew. Mellona is the package family. Agent Hive is
the current product. Install with the `[console]` extra to get the live operator UI alongside the `hive` CLI.

## Install

Pick the installer you already trust:

```bash
uv tool install 'mellona-hive[console]'
```

```bash
pipx install 'mellona-hive[console]'
```

```bash
python -m pip install 'mellona-hive[console]'
```

Then verify:

```bash
hive --version
hive doctor
```

> **CLI-only install:** For headless servers or CI, `uv tool install mellona-hive` gives you the base
> CLI without console dependencies.

The full install matrix, lane chooser, and maintainer split live in
[docs/START_HERE.md](https://github.com/intertwine/hive-orchestrator/blob/main/docs/START_HERE.md).

Additional extras (`mellona-hive[mcp]`, `mellona-hive[sandbox-e2b]`, `mellona-hive[sandbox-daytona]`):

- MCP adapter: `uv tool install --upgrade 'mellona-hive[console,mcp]'`
- Hosted E2B sandbox: `uv tool install --upgrade 'mellona-hive[console,sandbox-e2b]'`
- Self-hosted Daytona sandbox: `uv tool install --upgrade 'mellona-hive[console,sandbox-daytona]'`
- Homebrew: `brew install intertwine/tap/mellona-hive` (base CLI only, add extras through pip/uv/pipx)

If you install sandbox extras, verify the current machine with `hive sandbox doctor --json`.

## First Run

Start in an empty directory:

```bash
mkdir my-hive
cd my-hive
git init
hive onboard demo --prompt "Create a small React website about bees."
hive console serve
```

Open `http://127.0.0.1:8787/console/` to see your workspace in the operator console. Then use the
manager loop:

```bash
hive next --project-id demo
hive work --owner <your-name>
hive finish <run-id>
```

Governed edits happen inside the run worktree that `hive work` creates, not in the workspace root.

Fresh onboarded projects start with the placeholder `local-smoke` evaluator so the loop works immediately. Replace
it with a real repo-specific evaluator before you trust autonomous promotion.

## Choose The Right Guide

- Start here: [docs/START_HERE.md](https://github.com/intertwine/hive-orchestrator/blob/main/docs/START_HERE.md)
- Fresh workspace walkthrough: [docs/QUICKSTART.md](https://github.com/intertwine/hive-orchestrator/blob/main/docs/QUICKSTART.md)
- Existing repository adoption: [docs/ADOPT_EXISTING_REPO.md](https://github.com/intertwine/hive-orchestrator/blob/main/docs/ADOPT_EXISTING_REPO.md)
- Maintainer and release docs: [docs/MAINTAINING.md](https://github.com/intertwine/hive-orchestrator/blob/main/docs/MAINTAINING.md) and [docs/RELEASING.md](https://github.com/intertwine/hive-orchestrator/blob/main/docs/RELEASING.md)
