open-agent-fleet 1.0.0__tar.gz

open_agent_fleet-1.0.0/PKG-INFO

@@ -0,0 +1,115 @@
+Metadata-Version: 2.4
+Name: open-agent-fleet
+Version: 1.0.0
+Summary: Official Python SDK and fleetctl CLI for AgentFleet — self-hosted autonomous computer-use agents, each with its own Linux desktop
+Author-email: Bryant VanOrden <supermanismebvo123@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/BryantVanOrden/OpenAgentFleet
+Project-URL: Repository, https://github.com/BryantVanOrden/OpenAgentFleet
+Project-URL: Documentation, https://github.com/BryantVanOrden/OpenAgentFleet/tree/main/docs
+Project-URL: Changelog, https://github.com/BryantVanOrden/OpenAgentFleet/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/BryantVanOrden/OpenAgentFleet/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: urllib3>=2.0.0
+
+# AgentFleet Python SDK & `fleetctl` CLI
+
+Official Python SDK and command-line management client for
+[**AgentFleet**](https://github.com/BryantVanOrden/OpenAgentFleet) — the
+self-hosted platform for autonomous computer-use agents, where every agent
+gets its own disposable Linux desktop that streams live into your browser.
+
+---
+
+## 📦 Installation
+
+```bash
+pip install open-agent-fleet
+```
+
+That gives you the `agentfleet` package and the `fleetctl` CLI. To work from
+source instead:
+
+```bash
+git clone https://github.com/BryantVanOrden/OpenAgentFleet.git
+pip install -e OpenAgentFleet/sdk/python
+```
+
+The SDK is a client — it talks to an AgentFleet orchestrator. To run one,
+see the [main README](https://github.com/BryantVanOrden/OpenAgentFleet#readme)
+(`make up` is the whole quickstart).
+
+---
+
+## ⚡ Quickstart (Python SDK)
+
+```python
+from agentfleet import FleetClient
+
+# Connect to your local or remote orchestrator
+fleet = FleetClient("http://localhost:8080", token="your-api-token")
+
+# 1. Deploy a specialized bot archetype
+bot = fleet.deploy_bot("cyber_ops", name="security-auditor")
+print(f"Spawned {bot.name} (ID: {bot.id})")
+
+# 2. Run an autonomous goal
+task = bot.run("Run SAST vulnerability scan and compile CVSS briefing", wait=True)
+print(f"Task status: {task.state}")
+print(f"Result: {task.result}")
+
+# 3. Launch a collaborative multi-agent swarm
+swarm = fleet.launch_swarm(
+    name="Fintech Mobile Audit",
+    mission="Full-Stack Dev + QA Tester + CyberSec PenTester collaborative sweep",
+)
+
+# 4. Pocket TTS Voice Co-Pilot
+fleet.speak("All tasks completed successfully, operator.", voice="shadow")
+```
+
+---
+
+## 🛠️ Command-Line Interface (`fleetctl`)
+
+The `fleetctl` command-line utility provides full administrative control, live telemetry, and system diagnostics:
+
+```bash
+# 1. Configuration & Authentication
+fleetctl config set-url http://localhost:8080
+fleetctl login admin@example.com
+
+# 2. Comprehensive Diagnostics & Health Check
+fleetctl diagnostics
+
+# 3. List and Inspect Instances
+fleetctl list
+fleetctl inspect <instance_id>
+
+# 4. Deploy Bots
+fleetctl deploy --archetype cyber_ops --name "nightly-scanner"
+
+# 5. Execute Tasks & Stream Live Execution
+fleetctl run <instance_id> "Refactor backend authentication and run unit tests" --wait
+
+# 6. Multi-Agent Swarm Mission Control
+fleetctl swarm list
+fleetctl swarm launch --name "Security Sweep" --mission "Penetration test staging endpoints"
+fleetctl swarm watch <swarm_id>
+
+# 7. Real-Time Pocket TTS Voice
+fleetctl voice list
+fleetctl voice speak "System operational and standing by." --voice shadow
+
+# 8. Webhook & Autopilot Sinks
+fleetctl webhooks list
+fleetctl webhooks trigger github-pr-sync --data '{"pr": 42}'
+```

open_agent_fleet-1.0.0/README.md

@@ -0,0 +1,93 @@
+# AgentFleet Python SDK & `fleetctl` CLI
+
+Official Python SDK and command-line management client for
+[**AgentFleet**](https://github.com/BryantVanOrden/OpenAgentFleet) — the
+self-hosted platform for autonomous computer-use agents, where every agent
+gets its own disposable Linux desktop that streams live into your browser.
+
+---
+
+## 📦 Installation
+
+```bash
+pip install open-agent-fleet
+```
+
+That gives you the `agentfleet` package and the `fleetctl` CLI. To work from
+source instead:
+
+```bash
+git clone https://github.com/BryantVanOrden/OpenAgentFleet.git
+pip install -e OpenAgentFleet/sdk/python
+```
+
+The SDK is a client — it talks to an AgentFleet orchestrator. To run one,
+see the [main README](https://github.com/BryantVanOrden/OpenAgentFleet#readme)
+(`make up` is the whole quickstart).
+
+---
+
+## ⚡ Quickstart (Python SDK)
+
+```python
+from agentfleet import FleetClient
+
+# Connect to your local or remote orchestrator
+fleet = FleetClient("http://localhost:8080", token="your-api-token")
+
+# 1. Deploy a specialized bot archetype
+bot = fleet.deploy_bot("cyber_ops", name="security-auditor")
+print(f"Spawned {bot.name} (ID: {bot.id})")
+
+# 2. Run an autonomous goal
+task = bot.run("Run SAST vulnerability scan and compile CVSS briefing", wait=True)
+print(f"Task status: {task.state}")
+print(f"Result: {task.result}")
+
+# 3. Launch a collaborative multi-agent swarm
+swarm = fleet.launch_swarm(
+    name="Fintech Mobile Audit",
+    mission="Full-Stack Dev + QA Tester + CyberSec PenTester collaborative sweep",
+)
+
+# 4. Pocket TTS Voice Co-Pilot
+fleet.speak("All tasks completed successfully, operator.", voice="shadow")
+```
+
+---
+
+## 🛠️ Command-Line Interface (`fleetctl`)
+
+The `fleetctl` command-line utility provides full administrative control, live telemetry, and system diagnostics:
+
+```bash
+# 1. Configuration & Authentication
+fleetctl config set-url http://localhost:8080
+fleetctl login admin@example.com
+
+# 2. Comprehensive Diagnostics & Health Check
+fleetctl diagnostics
+
+# 3. List and Inspect Instances
+fleetctl list
+fleetctl inspect <instance_id>
+
+# 4. Deploy Bots
+fleetctl deploy --archetype cyber_ops --name "nightly-scanner"
+
+# 5. Execute Tasks & Stream Live Execution
+fleetctl run <instance_id> "Refactor backend authentication and run unit tests" --wait
+
+# 6. Multi-Agent Swarm Mission Control
+fleetctl swarm list
+fleetctl swarm launch --name "Security Sweep" --mission "Penetration test staging endpoints"
+fleetctl swarm watch <swarm_id>
+
+# 7. Real-Time Pocket TTS Voice
+fleetctl voice list
+fleetctl voice speak "System operational and standing by." --voice shadow
+
+# 8. Webhook & Autopilot Sinks
+fleetctl webhooks list
+fleetctl webhooks trigger github-pr-sync --data '{"pr": 42}'
+```

open_agent_fleet-1.0.0/agentfleet/__init__.py

@@ -0,0 +1,30 @@
+"""AgentFleet Python SDK."""
+
+from agentfleet.bot import Bot
+from agentfleet.client import FleetClient
+from agentfleet.exceptions import (
+    FleetApiError,
+    FleetAuthError,
+    FleetError,
+    FleetNotFoundError,
+    FleetTimeoutError,
+)
+from agentfleet.models import InstanceInfo, SwarmTeamInfo, TaskInfo
+from agentfleet.swarm import Swarm
+from agentfleet.task import Task
+
+__version__ = "1.0.0"
+__all__ = [
+    "FleetClient",
+    "Bot",
+    "Task",
+    "Swarm",
+    "InstanceInfo",
+    "TaskInfo",
+    "SwarmTeamInfo",
+    "FleetError",
+    "FleetApiError",
+    "FleetAuthError",
+    "FleetNotFoundError",
+    "FleetTimeoutError",
+]

open_agent_fleet-1.0.0/agentfleet/bot.py

@@ -0,0 +1,88 @@
+"""Bot instance abstraction."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, Optional
+
+from agentfleet.models import InstanceInfo, TaskInfo
+from agentfleet.task import Task
+
+if TYPE_CHECKING:
+    from agentfleet.client import FleetClient
+
+
+class Bot:
+    """Represents a provisioned sandbox bot instance."""
+
+    def __init__(self, client: FleetClient, info: InstanceInfo) -> None:
+        self._client = client
+        self.info = info
+
+    @property
+    def id(self) -> str:
+        return self.info.id
+
+    @property
+    def name(self) -> str:
+        return self.info.name
+
+    @property
+    def archetype_id(self) -> Optional[str]:
+        return self.info.archetype_id
+
+    @property
+    def state(self) -> str:
+        return self.info.state
+
+    @property
+    def tier(self) -> str:
+        return self.info.tier
+
+    def refresh(self) -> Bot:
+        """Fetches the latest state from the orchestrator."""
+        data = self._client._get(f"/api/instances/{self.id}")
+        self.info = InstanceInfo.from_dict(data)
+        return self
+
+    def start(self) -> Bot:
+        """Starts the sandbox container."""
+        self._client._post(f"/api/instances/{self.id}/start")
+        return self.refresh()
+
+    def stop(self) -> Bot:
+        """Stops the sandbox container."""
+        self._client._post(f"/api/instances/{self.id}/stop")
+        return self.refresh()
+
+    def delete(self) -> None:
+        """Destroys and removes the sandbox container."""
+        self._client._delete(f"/api/instances/{self.id}")
+
+    def run(
+        self,
+        goal: str,
+        max_steps: int = 60,
+        auto_refine: bool = True,
+        wait: bool = False,
+        timeout: float = 600.0,
+    ) -> Task:
+        """Dispatches an autonomous goal to this bot."""
+        payload = {
+            "instance_id": self.id,
+            "goal": goal,
+            "max_steps": max_steps,
+            "auto_refine": auto_refine,
+        }
+        res = self._client._post("/api/tasks", payload)
+        task = Task(self._client, TaskInfo.from_dict(res))
+        if wait:
+            task.wait(timeout=timeout)
+        return task
+
+    def observe(self) -> dict[str, Any]:
+        """Captures a live visual frame and active window telemetry."""
+        return self._client._get(f"/api/instances/{self.id}/observe")
+
+    def stats(self) -> dict[str, Any]:
+        """Gets CPU, RAM, and network I/O statistics."""
+        return self._client._get(f"/api/instances/{self.id}/stats")