opencommand 0.1.0__py3-none-any.whl

opencommand/swarm/agents/worker.py

@@ -0,0 +1,26 @@
+"""Worker: executes a single task via the AgentLoop and reports back.
+
+Workers are spawned by the Commander and supervised by the Supervisor. Each
+worker runs its own AgentLoop with the shared tool registry, completing one
+concrete task and returning a concise result.
+"""
+
+from __future__ import annotations
+
+from ...core.agent import AgentLoop
+from ...core.tools import ToolRegistry
+from ...providers.provider import BaseProvider
+
+
+class Worker:
+    """Wraps an AgentLoop for one assigned task."""
+
+    def __init__(self, provider: BaseProvider, tools: ToolRegistry, name: str = "worker") -> None:
+        self.provider = provider
+        self.tools = tools
+        self.name = name
+        self.loop = AgentLoop(provider, tools, platform="this machine")
+
+    async def execute(self, task: str, max_steps: int = 40) -> str:
+        return await self.loop.run(task, max_steps=max_steps)
+

opencommand/tui/dashboard.py

@@ -0,0 +1,41 @@
+"""Live swarm dashboard built with asciimatics.
+
+Shows the supervisor's worker handles, their status, and a log feed. This is a
+standalone viewer; the Commander/Supervisor drive the actual work and push
+status here via a shared Supervisor instance.
+"""
+
+from __future__ import annotations
+
+from asciimatics.screen import Screen
+from asciimatics.scene import Scene
+from asciimatics.widgets import Frame, TextBox, Widget
+
+from ..core.supervisor import Supervisor
+
+
+class DashboardFrame(Frame):
+    def __init__(self, screen, supervisor: Supervisor) -> None:
+        super().__init__(screen, screen.height, screen.width, title="OpenCommand Swarm")
+        self._supervisor = supervisor
+        self._log = TextBox(Widget.FILL_FRAME, readonly=True, name="log")
+
+    def update(self, frame_no: int) -> None:
+        lines = [self._supervisor.summary(), "", "Recent activity:"]
+        for h in self._supervisor.handles.values():
+            if h.result:
+                lines.append(f"  {h.name}: {h.result[:80]}")
+            elif h.error:
+                lines.append(f"  {h.name}: ERR {h.error[:80]}")
+        self._log.value = "\n".join(lines)
+        super().update(frame_no)
+
+
+def run_dashboard(supervisor: Supervisor | None = None) -> None:
+    sup = supervisor or Supervisor()
+
+    def demo(screen) -> None:
+        frame = DashboardFrame(screen, sup)
+        screen.play([Scene([frame], -1)], stop_on_resize=True)
+
+    Screen.wrap(demo)

opencommand-0.1.0.dist-info/METADATA

@@ -0,0 +1,76 @@
+Metadata-Version: 2.3
+Name: opencommand
+Version: 0.1.0
+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: 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
+ 

opencommand-0.1.0.dist-info/RECORD

@@ -0,0 +1,37 @@
+opencommand/__init__.py,sha256=zYy4UVEfO_wHoUOydXtX145zjQg4t5kswXB7tpTiZGk,56
+opencommand/cli.py,sha256=oMu_spoThMh3QFo37dKz1jYYkI3CEp_GbQ_ymw3TG7M,14882
+opencommand/core/agent.py,sha256=rORwv5sXB3xhzr4-Z4ppDcsOQ0hjTTghbtMklHM1lxk,4126
+opencommand/core/config.py,sha256=HvGo5vFa21up-_rGdzsN8nZAJFlCxduhPfZ3GrfJd8c,2448
+opencommand/core/errors.py,sha256=u4b5QSxnHJoGx_EZNSUV4b-6R5vqW0UD9a4U2BG8kvM,611
+opencommand/core/logging.py,sha256=5CEGl1O5fFQ4GLFF2qdTrOIhe2r7mev6Fmy4xLvJfCQ,2123
+opencommand/core/supervisor.py,sha256=PS3Wb-mKvGFJo38gyUACzar4aJuzu3they76dwSKvto,3154
+opencommand/core/tools.py,sha256=GPMo68aV4gJFPS3tPoAUw5wSDoRTp18ogUlZF1BF-6A,4174
+opencommand/engine/__init__.py,sha256=DgCgJAwCYhIhmjdLtbBtpT0jBklmx0SCGj_XOvXeAco,2668
+opencommand/engine/runner.py,sha256=frXXDorHK8KsmiDOqVjBe-HQTo9xFH-eZ8ZaNglupaE,12155
+opencommand/modules/knowledge.py,sha256=LH76Z_iSZPw6Mz8Cv1QUP4PoVgS_mHXqIvAyUV6JoVk,3265
+opencommand/modules/memory/MEMORY.md,sha256=0xnznqvOk5YoXAOnXQ4H-XnMO7MdBqE2_eBw9jYVaN4,560
+opencommand/modules/skills/bash.md,sha256=LztU0IP4uMmnuf5c_v-jDwtQ8mfmyJ2yoN0wmR-peHU,585
+opencommand/modules/skills/powershell.md,sha256=qN8gW4O1Yc-GXR4-pUVsD9fjKBOvumhlDUWpePkURLw,657
+opencommand/modules/skills/python.md,sha256=N9Rbj8KmotpSyi2Zbsui3dDOTTktKDlyi1zbL1INBto,884
+opencommand/modules/skills/system.md,sha256=Lhw1BWW89MtT6EwMK1VXx9Uop8PGvTXz_C-LYPfa0cw,1809
+opencommand/modules/system/automatic.py,sha256=Zr-c-Qe-xlhdfSYGK9SjNSjQ3QKnlzw3Bi6lLHvaFcE,7696
+opencommand/modules/system/cron.py,sha256=WqdWytrtANfihc4tyGwYgkDrcjJ8rldd_5YNU8zoh-4,7637
+opencommand/modules/system/notify.py,sha256=Hh39irUAi87OrGmm7yvoARk1-XFro_7Mu6-lRmHsrpw,3145
+opencommand/modules/system/platform.py,sha256=nEKLM7a5vFxQKsDD1_W8H2dXZZGLmwzEubepBXqdkkA,7462
+opencommand/modules/templates.py,sha256=mnqasrovhPP2zReW7-RqI21GcbVi3-eP52HCz49VecM,7373
+opencommand/modules/tools/desktop.py,sha256=tlGx7gKh8Wr9qjb2TPBgZDlE1IF-GGDGfF9nvbZK46o,4832
+opencommand/modules/tools/files.py,sha256=qJnnRh3XsskkCgjtCVzLEVfRSPD-Yr_2q2wyI8FEky4,3429
+opencommand/modules/tools/instructions.py,sha256=UakXmenQ8zMme49vjMQkxnwBSQNVIVKT7oC25tlS214,6604
+opencommand/modules/tools/memory.py,sha256=29qHbpTWmsLteTAjCFGdafTn17Fj4b99C8SThDtk1VM,2949
+opencommand/modules/tools/playwright.py,sha256=iVAzbIMwPOODUurPYg1BLjLnGpmWmZ16Fj3xY12ZIjs,2363
+opencommand/modules/tools/research.py,sha256=ChsnRGy2gmDvYU0_BIkNXL8y9TbfNB29YlEYht2JLN0,1566
+opencommand/modules/tools/system.py,sha256=ao_ApwDzgrGpkjaaCBpmCiutXndMt4OgsdWsByKXIEk,6634
+opencommand/modules/tools/terminal.py,sha256=wkgaXqejrxGtCyWFa7OetmMDVfPcmDSO9HyjgBGckF8,1870
+opencommand/providers/provider.py,sha256=udWAi9Dht8IuEQ8gTwRxiDpw5e85b3c0AAccLatUpfg,5956
+opencommand/swarm/agents/commander.py,sha256=am9bThyp2nZFMsVdT5IzFA6U5MY9EgjnQlY3EaWuCwU,26039
+opencommand/swarm/agents/worker.py,sha256=y2h-xlDhTX64bmoVv_Yt_3DvWSrQqpmrhauSzLsdOew,915
+opencommand/tui/dashboard.py,sha256=G8t0v_UwoL5ptiVhl2et_hoyrpQrF_DpdFkmKUL1I40,1482
+opencommand-0.1.0.dist-info/WHEEL,sha256=CoDSoyhtC_eO_tlxRYzsTraPv1fPJRXFx91k6ISeAvA,81
+opencommand-0.1.0.dist-info/entry_points.txt,sha256=VmJs_vXCuPS-_7J8BZaFHJlJpetQoXc9V_hnXJvkb3I,50
+opencommand-0.1.0.dist-info/METADATA,sha256=Qvcki_8W17Ed9tsQhx0gANOTJljqJbUYxVGAqm3ht3I,2822
+opencommand-0.1.0.dist-info/RECORD,,

opencommand-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.11.28
+Root-Is-Purelib: true
+Tag: py3-none-any

opencommand-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+opencommand = opencommand:main
+