Metadata-Version: 2.3
Name: opencommand
Version: 0.1.1
Summary: Local-first swarm agent framework: a Commander plans and dispatches a swarm of Workers that research, code, test, and interactively drive the computer to complete long-horizon codebase goals.
Author: DSiENT
Author-email: DSiENT <w.caskey7@gmail.com>
Requires-Dist: asciimatics>=1.15.0
Requires-Dist: click>=8.4.2
Requires-Dist: playwright>=1.61.0
Requires-Dist: pyautogui>=0.9.54
Requires-Dist: pynput>=1.8.2
Requires-Dist: requests>=2.34.2
Requires-Dist: mss>=9.0.0
Requires-Dist: pillow>=11.0.0
Requires-Dist: llama-cpp-python>=0.3.33
Requires-Dist: huggingface-hub>=0.30.0
Requires-Dist: watchdog>=6.0.0
Requires-Dist: ntfy>=2.7.1
Requires-Python: >=3.14
Project-URL: Homepage, https://github.com/D5-Interactive/OpenCommand
Project-URL: Repository, https://github.com/D5-Interactive/OpenCommand
Description-Content-Type: text/markdown

# OpenCommand

Local-first swarm agent framework. A **Commander** model plans and dispatches a
swarm of **Workers** that research, code, test, and interactively drive the
computer (mouse, keyboard, screen) to complete long-horizon codebase goals.

Everything runs **embedded** — models are GGUF files loaded directly with
`llama-cpp-python` (no API servers, no network at runtime). Designed for
**Python 3.14** (free-threaded).

## Install

```bash
# Run without installing (ephemeral):
uv tool run opencommand --help

# Or install globally:
uv tool install opencommand
playwright install   # optional, for the playwright tool
```

> **Note:** the `llama-cpp-python` prebuilt CPU wheel may crash on older CPUs
> (illegal-instruction). If so, rebuild from source with AVX2:
> ```bat
> call "C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Auxiliary\Build\vcvars64.bat"
> set CMAKE_ARGS=-DGGML_AVX2=ON
> uv pip install --no-binary llama-cpp-python --no-cache llama-cpp-python
> ```

## Usage

```bash
opencommand models list                 # list built-in embedded models
opencommand models pull all             # download GGUF models into ./models
opencommand run "Add unit tests for the engine module."
opencommand run "Build a Panda3D FPS" --pipeline advanced --verify "uv run pytest -q"
opencommand tui                         # live swarm dashboard
opencommand cron add healthcheck "every 1h" "echo ok"
```

## Built-in models

| Role          | Model                                  |
|---------------|----------------------------------------|
| commander     | `deepreinforce-ai/Ornith-1.0-9B-GGUF`  |
| worker        | `unsloth/Qwen3-4B-Instruct-2507-GGUF`  |
| vision        | `unsloth/Qwen3-VL-4B-Instruct-GGUF`    |
| vision_small  | `openbmb/MiniCPM-V-4.6-gguf`           |

## Links

- `DESIGN.md` — full architecture & research notes
- `TODO.md` — roadmap tracker
 
