cyclo-manager 0.1.0__tar.gz

cyclo_manager-0.1.0/PKG-INFO

@@ -0,0 +1,138 @@
+Metadata-Version: 2.4
+Name: cyclo-manager
+Version: 0.1.0
+Summary: cyclo_manager CLI: pip-installable launcher for cyclo_manager server and UI containers. Run 'cyclo_manager up' to start Docker stack.
+License-Expression: Apache-2.0
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+
+# cyclo_manager CLI
+
+**PyPI package:** `cyclo-manager`  
+**Console command:** `cyclo_manager` (underscore)
+
+This package is a **thin launcher**: it runs **`docker compose`** against a **bundled** [`cyclo_manager_cli/docker/docker-compose.yml`](cyclo_manager_cli/docker/docker-compose.yml) so you can start the **cyclo_manager API** and **web UI** without cloning the monorepo. Optional services (**Zenoh**, **noVNC**) are **created** but **not started** by default. It can also **`pip install -U`** itself and bring the stack back up.
+
+Implementation: [`cyclo_manager_cli/cli.py`](cyclo_manager_cli/cli.py).
+
+---
+
+## Table of contents
+
+- [cyclo\_manager CLI](#cyclo_manager-cli)
+  - [Table of contents](#table-of-contents)
+  - [Prerequisites](#prerequisites)
+  - [Install](#install)
+  - [Commands](#commands)
+  - [Compose: services and behavior](#compose-services-and-behavior)
+  - [Config and environment](#config-and-environment)
+  - [Bundled `config.yml`](#bundled-configyml)
+  - [URLs (packaged stack)](#urls-packaged-stack)
+  - [Dependencies](#dependencies)
+  - [License](#license)
+
+---
+
+## Prerequisites
+
+- **Docker** with **Compose v2** (`docker compose` — the legacy `docker-compose` binary alone is not enough)
+- **Python 3.10+**
+- For **`cyclo_manager update`:** **`pip`** or **`pip3`** on `PATH`
+- On the **host:** agent sockets are expected under **`/var/run/robotis/agent_sockets`** and are mounted into the API container as **`/agents`** (see the bundled Compose file). Adjust only if you maintain a custom setup.
+
+---
+
+## Install
+
+Install from **PyPI**:
+
+```bash
+pip install cyclo-manager
+```
+
+If `cyclo_manager` is not on `PATH`, add the user script directory, e.g.:
+
+```bash
+export PATH="$HOME/.local/bin:$PATH"
+cyclo_manager up
+```
+
+If the entry point is still missing:
+
+```bash
+python3 -m cyclo_manager_cli.cli --help
+python3 -m cyclo_manager_cli.cli up
+```
+
+---
+
+## Commands
+
+| Command | Behavior |
+|--------|----------|
+| `cyclo_manager up` | `docker compose up -d` for **`cyclo_manager`** and **`ui`**, then `docker compose create --no-recreate` for **`rmw_zenoh`** and **`novnc-server`** so those containers **exist** but stay **stopped**. Sets **`CYCLO_MANAGER_CONFIG_FILE`** to the **bundled** [`cyclo_manager_cli/config/config.yml`](cyclo_manager_cli/config/config.yml) (no CLI flag to use another file). |
+| `cyclo_manager up --pull` | Runs `docker compose pull` first, then the same as `up`. |
+| `cyclo_manager down` | `docker compose down` using the **packaged** compose file. Stops and removes **all** services defined in that file for this Compose project (not only API + UI). |
+| `cyclo_manager update` | Runs `cyclo_manager down`, `pip install -U cyclo-manager`, then `cyclo_manager up`. Optional `--pull` is passed through to the final `up`. Requires **`cyclo_manager`** and **`pip`** on `PATH`. |
+| `cyclo_manager --help` | Subcommand overview |
+
+---
+
+## Compose: services and behavior
+
+| Compose service | Container name (typical) | `cyclo_manager up` |
+|-----------------|-------------------------|--------------------|
+| `cyclo_manager` | `cyclo_manager` | **Started** |
+| `ui` | `cyclo_manager_ui` | **Started** |
+| `rmw_zenoh` | `zenoh_daemon` | **Created only** (start e.g. from the Control UI or `docker start zenoh_daemon`) |
+| `novnc-server` | `novnc-server` | **Created only** (start when needed, e.g. `docker start novnc-server`) |
+
+The bundled stack uses **`network_mode: host`** (see the Compose file). Image names and tags (e.g. `robotis/cyclo-manager`, `robotis/cyclo-manager-ui`) are defined in [`cyclo_manager_cli/docker/docker-compose.yml`](cyclo_manager_cli/docker/docker-compose.yml).
+
+---
+
+## Config and environment
+
+- **`CYCLO_MANAGER_CONFIG_FILE`**: set automatically by the CLI to the absolute path of the **bundled** [`cyclo_manager_cli/config/config.yml`](cyclo_manager_cli/config/config.yml) on the host, and consumed by Compose as the mount for `/app/config.yml` in the API container. `up` and `down` both set this.
+- **`ROS_DOMAIN_ID`**: **not** set by the CLI. Set DDS domain in each container’s environment (e.g. `~/.bashrc` inside the image) so it matches your robots, then restart as needed.
+- For a **custom** config file, different mounts, or local source builds, use the repository’s **`docker-compose.dev.yml`** at the [project root](../README.md#how-to-run) instead of the pip-bundled workflow.
+
+---
+
+## Bundled `config.yml`
+
+Path: [`cyclo_manager_cli/config/config.yml`](cyclo_manager_cli/config/config.yml)
+
+It only defines **which containers cyclo_manager knows about** and the **agent Unix socket path** (as seen from the API process, under `/agents` in the default Compose setup), for example:
+
+- `ai_worker` → `/agents/ai_worker/s6_agent.sock`
+- `physical_ai_server` → `/agents/physical_ai_server/s6_agent.sock`
+
+**s6 service names** are **not** listed here; the agent in each container reports them at runtime.
+
+---
+
+## URLs (packaged stack)
+
+With `network_mode: host` and the defaults in Compose:
+
+| What | URL |
+|------|-----|
+| cyclo_manager API | http://127.0.0.1:8081 |
+| OpenAPI (Swagger) | http://127.0.0.1:8081/docs |
+| Web UI | http://127.0.0.1:3000 |
+
+---
+
+## Dependencies
+
+The **`cyclo-manager`** package declares **no** Python runtime dependencies in [`pyproject.toml`](pyproject.toml). It invokes **`docker compose`** and, for **`update`**, **`pip`**.
+
+---
+
+## License
+
+SPDX: **Apache-2.0** (see [pyproject.toml](pyproject.toml) and the repository [LICENSE](../LICENSE)).

cyclo_manager-0.1.0/README.md

@@ -0,0 +1,127 @@
+# cyclo_manager CLI
+
+**PyPI package:** `cyclo-manager`  
+**Console command:** `cyclo_manager` (underscore)
+
+This package is a **thin launcher**: it runs **`docker compose`** against a **bundled** [`cyclo_manager_cli/docker/docker-compose.yml`](cyclo_manager_cli/docker/docker-compose.yml) so you can start the **cyclo_manager API** and **web UI** without cloning the monorepo. Optional services (**Zenoh**, **noVNC**) are **created** but **not started** by default. It can also **`pip install -U`** itself and bring the stack back up.
+
+Implementation: [`cyclo_manager_cli/cli.py`](cyclo_manager_cli/cli.py).
+
+---
+
+## Table of contents
+
+- [cyclo\_manager CLI](#cyclo_manager-cli)
+  - [Table of contents](#table-of-contents)
+  - [Prerequisites](#prerequisites)
+  - [Install](#install)
+  - [Commands](#commands)
+  - [Compose: services and behavior](#compose-services-and-behavior)
+  - [Config and environment](#config-and-environment)
+  - [Bundled `config.yml`](#bundled-configyml)
+  - [URLs (packaged stack)](#urls-packaged-stack)
+  - [Dependencies](#dependencies)
+  - [License](#license)
+
+---
+
+## Prerequisites
+
+- **Docker** with **Compose v2** (`docker compose` — the legacy `docker-compose` binary alone is not enough)
+- **Python 3.10+**
+- For **`cyclo_manager update`:** **`pip`** or **`pip3`** on `PATH`
+- On the **host:** agent sockets are expected under **`/var/run/robotis/agent_sockets`** and are mounted into the API container as **`/agents`** (see the bundled Compose file). Adjust only if you maintain a custom setup.
+
+---
+
+## Install
+
+Install from **PyPI**:
+
+```bash
+pip install cyclo-manager
+```
+
+If `cyclo_manager` is not on `PATH`, add the user script directory, e.g.:
+
+```bash
+export PATH="$HOME/.local/bin:$PATH"
+cyclo_manager up
+```
+
+If the entry point is still missing:
+
+```bash
+python3 -m cyclo_manager_cli.cli --help
+python3 -m cyclo_manager_cli.cli up
+```
+
+---
+
+## Commands
+
+| Command | Behavior |
+|--------|----------|
+| `cyclo_manager up` | `docker compose up -d` for **`cyclo_manager`** and **`ui`**, then `docker compose create --no-recreate` for **`rmw_zenoh`** and **`novnc-server`** so those containers **exist** but stay **stopped**. Sets **`CYCLO_MANAGER_CONFIG_FILE`** to the **bundled** [`cyclo_manager_cli/config/config.yml`](cyclo_manager_cli/config/config.yml) (no CLI flag to use another file). |
+| `cyclo_manager up --pull` | Runs `docker compose pull` first, then the same as `up`. |
+| `cyclo_manager down` | `docker compose down` using the **packaged** compose file. Stops and removes **all** services defined in that file for this Compose project (not only API + UI). |
+| `cyclo_manager update` | Runs `cyclo_manager down`, `pip install -U cyclo-manager`, then `cyclo_manager up`. Optional `--pull` is passed through to the final `up`. Requires **`cyclo_manager`** and **`pip`** on `PATH`. |
+| `cyclo_manager --help` | Subcommand overview |
+
+---
+
+## Compose: services and behavior
+
+| Compose service | Container name (typical) | `cyclo_manager up` |
+|-----------------|-------------------------|--------------------|
+| `cyclo_manager` | `cyclo_manager` | **Started** |
+| `ui` | `cyclo_manager_ui` | **Started** |
+| `rmw_zenoh` | `zenoh_daemon` | **Created only** (start e.g. from the Control UI or `docker start zenoh_daemon`) |
+| `novnc-server` | `novnc-server` | **Created only** (start when needed, e.g. `docker start novnc-server`) |
+
+The bundled stack uses **`network_mode: host`** (see the Compose file). Image names and tags (e.g. `robotis/cyclo-manager`, `robotis/cyclo-manager-ui`) are defined in [`cyclo_manager_cli/docker/docker-compose.yml`](cyclo_manager_cli/docker/docker-compose.yml).
+
+---
+
+## Config and environment
+
+- **`CYCLO_MANAGER_CONFIG_FILE`**: set automatically by the CLI to the absolute path of the **bundled** [`cyclo_manager_cli/config/config.yml`](cyclo_manager_cli/config/config.yml) on the host, and consumed by Compose as the mount for `/app/config.yml` in the API container. `up` and `down` both set this.
+- **`ROS_DOMAIN_ID`**: **not** set by the CLI. Set DDS domain in each container’s environment (e.g. `~/.bashrc` inside the image) so it matches your robots, then restart as needed.
+- For a **custom** config file, different mounts, or local source builds, use the repository’s **`docker-compose.dev.yml`** at the [project root](../README.md#how-to-run) instead of the pip-bundled workflow.
+
+---
+
+## Bundled `config.yml`
+
+Path: [`cyclo_manager_cli/config/config.yml`](cyclo_manager_cli/config/config.yml)
+
+It only defines **which containers cyclo_manager knows about** and the **agent Unix socket path** (as seen from the API process, under `/agents` in the default Compose setup), for example:
+
+- `ai_worker` → `/agents/ai_worker/s6_agent.sock`
+- `physical_ai_server` → `/agents/physical_ai_server/s6_agent.sock`
+
+**s6 service names** are **not** listed here; the agent in each container reports them at runtime.
+
+---
+
+## URLs (packaged stack)
+
+With `network_mode: host` and the defaults in Compose:
+
+| What | URL |
+|------|-----|
+| cyclo_manager API | http://127.0.0.1:8081 |
+| OpenAPI (Swagger) | http://127.0.0.1:8081/docs |
+| Web UI | http://127.0.0.1:3000 |
+
+---
+
+## Dependencies
+
+The **`cyclo-manager`** package declares **no** Python runtime dependencies in [`pyproject.toml`](pyproject.toml). It invokes **`docker compose`** and, for **`update`**, **`pip`**.
+
+---
+
+## License
+
+SPDX: **Apache-2.0** (see [pyproject.toml](pyproject.toml) and the repository [LICENSE](../LICENSE)).

cyclo_manager-0.1.0/cyclo_manager.egg-info/PKG-INFO

@@ -0,0 +1,138 @@
+Metadata-Version: 2.4
+Name: cyclo-manager
+Version: 0.1.0
+Summary: cyclo_manager CLI: pip-installable launcher for cyclo_manager server and UI containers. Run 'cyclo_manager up' to start Docker stack.
+License-Expression: Apache-2.0
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+
+# cyclo_manager CLI
+
+**PyPI package:** `cyclo-manager`  
+**Console command:** `cyclo_manager` (underscore)
+
+This package is a **thin launcher**: it runs **`docker compose`** against a **bundled** [`cyclo_manager_cli/docker/docker-compose.yml`](cyclo_manager_cli/docker/docker-compose.yml) so you can start the **cyclo_manager API** and **web UI** without cloning the monorepo. Optional services (**Zenoh**, **noVNC**) are **created** but **not started** by default. It can also **`pip install -U`** itself and bring the stack back up.
+
+Implementation: [`cyclo_manager_cli/cli.py`](cyclo_manager_cli/cli.py).
+
+---
+
+## Table of contents
+
+- [cyclo\_manager CLI](#cyclo_manager-cli)
+  - [Table of contents](#table-of-contents)
+  - [Prerequisites](#prerequisites)
+  - [Install](#install)
+  - [Commands](#commands)
+  - [Compose: services and behavior](#compose-services-and-behavior)
+  - [Config and environment](#config-and-environment)
+  - [Bundled `config.yml`](#bundled-configyml)
+  - [URLs (packaged stack)](#urls-packaged-stack)
+  - [Dependencies](#dependencies)
+  - [License](#license)
+
+---
+
+## Prerequisites
+
+- **Docker** with **Compose v2** (`docker compose` — the legacy `docker-compose` binary alone is not enough)
+- **Python 3.10+**
+- For **`cyclo_manager update`:** **`pip`** or **`pip3`** on `PATH`
+- On the **host:** agent sockets are expected under **`/var/run/robotis/agent_sockets`** and are mounted into the API container as **`/agents`** (see the bundled Compose file). Adjust only if you maintain a custom setup.
+
+---
+
+## Install
+
+Install from **PyPI**:
+
+```bash
+pip install cyclo-manager
+```
+
+If `cyclo_manager` is not on `PATH`, add the user script directory, e.g.:
+
+```bash
+export PATH="$HOME/.local/bin:$PATH"
+cyclo_manager up
+```
+
+If the entry point is still missing:
+
+```bash
+python3 -m cyclo_manager_cli.cli --help
+python3 -m cyclo_manager_cli.cli up
+```
+
+---
+
+## Commands
+
+| Command | Behavior |
+|--------|----------|
+| `cyclo_manager up` | `docker compose up -d` for **`cyclo_manager`** and **`ui`**, then `docker compose create --no-recreate` for **`rmw_zenoh`** and **`novnc-server`** so those containers **exist** but stay **stopped**. Sets **`CYCLO_MANAGER_CONFIG_FILE`** to the **bundled** [`cyclo_manager_cli/config/config.yml`](cyclo_manager_cli/config/config.yml) (no CLI flag to use another file). |
+| `cyclo_manager up --pull` | Runs `docker compose pull` first, then the same as `up`. |
+| `cyclo_manager down` | `docker compose down` using the **packaged** compose file. Stops and removes **all** services defined in that file for this Compose project (not only API + UI). |
+| `cyclo_manager update` | Runs `cyclo_manager down`, `pip install -U cyclo-manager`, then `cyclo_manager up`. Optional `--pull` is passed through to the final `up`. Requires **`cyclo_manager`** and **`pip`** on `PATH`. |
+| `cyclo_manager --help` | Subcommand overview |
+
+---
+
+## Compose: services and behavior
+
+| Compose service | Container name (typical) | `cyclo_manager up` |
+|-----------------|-------------------------|--------------------|
+| `cyclo_manager` | `cyclo_manager` | **Started** |
+| `ui` | `cyclo_manager_ui` | **Started** |
+| `rmw_zenoh` | `zenoh_daemon` | **Created only** (start e.g. from the Control UI or `docker start zenoh_daemon`) |
+| `novnc-server` | `novnc-server` | **Created only** (start when needed, e.g. `docker start novnc-server`) |
+
+The bundled stack uses **`network_mode: host`** (see the Compose file). Image names and tags (e.g. `robotis/cyclo-manager`, `robotis/cyclo-manager-ui`) are defined in [`cyclo_manager_cli/docker/docker-compose.yml`](cyclo_manager_cli/docker/docker-compose.yml).
+
+---
+
+## Config and environment
+
+- **`CYCLO_MANAGER_CONFIG_FILE`**: set automatically by the CLI to the absolute path of the **bundled** [`cyclo_manager_cli/config/config.yml`](cyclo_manager_cli/config/config.yml) on the host, and consumed by Compose as the mount for `/app/config.yml` in the API container. `up` and `down` both set this.
+- **`ROS_DOMAIN_ID`**: **not** set by the CLI. Set DDS domain in each container’s environment (e.g. `~/.bashrc` inside the image) so it matches your robots, then restart as needed.
+- For a **custom** config file, different mounts, or local source builds, use the repository’s **`docker-compose.dev.yml`** at the [project root](../README.md#how-to-run) instead of the pip-bundled workflow.
+
+---
+
+## Bundled `config.yml`
+
+Path: [`cyclo_manager_cli/config/config.yml`](cyclo_manager_cli/config/config.yml)
+
+It only defines **which containers cyclo_manager knows about** and the **agent Unix socket path** (as seen from the API process, under `/agents` in the default Compose setup), for example:
+
+- `ai_worker` → `/agents/ai_worker/s6_agent.sock`
+- `physical_ai_server` → `/agents/physical_ai_server/s6_agent.sock`
+
+**s6 service names** are **not** listed here; the agent in each container reports them at runtime.
+
+---
+
+## URLs (packaged stack)
+
+With `network_mode: host` and the defaults in Compose:
+
+| What | URL |
+|------|-----|
+| cyclo_manager API | http://127.0.0.1:8081 |
+| OpenAPI (Swagger) | http://127.0.0.1:8081/docs |
+| Web UI | http://127.0.0.1:3000 |
+
+---
+
+## Dependencies
+
+The **`cyclo-manager`** package declares **no** Python runtime dependencies in [`pyproject.toml`](pyproject.toml). It invokes **`docker compose`** and, for **`update`**, **`pip`**.
+
+---
+
+## License
+
+SPDX: **Apache-2.0** (see [pyproject.toml](pyproject.toml) and the repository [LICENSE](../LICENSE)).

cyclo_manager-0.1.0/cyclo_manager.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+README.md
+pyproject.toml
+setup.cfg
+cyclo_manager.egg-info/PKG-INFO
+cyclo_manager.egg-info/SOURCES.txt
+cyclo_manager.egg-info/dependency_links.txt
+cyclo_manager.egg-info/entry_points.txt
+cyclo_manager.egg-info/requires.txt
+cyclo_manager.egg-info/top_level.txt
+cyclo_manager_cli/__init__.py
+cyclo_manager_cli/cli.py
+cyclo_manager_cli/config/config.yml
+cyclo_manager_cli/docker/docker-compose.yml

cyclo_manager-0.1.0/cyclo_manager.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

cyclo_manager-0.1.0/cyclo_manager.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+cyclo_manager = cyclo_manager_cli.cli:main

cyclo_manager-0.1.0/cyclo_manager.egg-info/requires.txt

@@ -0,0 +1,4 @@
+
+[dev]
+pytest
+ruff

cyclo_manager-0.1.0/cyclo_manager.egg-info/top_level.txt

@@ -0,0 +1 @@
+cyclo_manager_cli

cyclo_manager-0.1.0/cyclo_manager_cli/__init__.py

@@ -0,0 +1,3 @@
+"""cyclo_manager CLI - pip-installable launcher for cyclo_manager server and UI containers."""
+
+__version__ = "0.1.0"

cyclo_manager-0.1.0/cyclo_manager_cli/cli.py

@@ -0,0 +1,171 @@
+"""CLI for pip-installed cyclo_manager_cli: cyclo_manager up, cyclo_manager down, cyclo_manager update. Launches cyclo_manager server and UI via Docker."""
+
+import argparse
+import os
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+
+PYPI_PACKAGE = "cyclo-manager"
+
+# `cyclo_manager up` starts these immediately.
+COMPOSE_SERVICES_UP = ("cyclo_manager", "ui")
+# These get `docker compose create` only (stopped); start from UI or `docker start` when needed.
+COMPOSE_SERVICES_CREATE_ONLY = ("rmw_zenoh", "novnc-server")
+
+
+def _docker_dir() -> Path:
+    return Path(__file__).resolve().parent / "docker"
+
+
+def _config_dir() -> Path:
+    return Path(__file__).resolve().parent / "config"
+
+
+def _packaged_config_path() -> Path:
+    """Path to the bundled config (config/config.yml). Used for cyclo_manager up/down."""
+    return _config_dir() / "config.yml"
+
+
+def cmd_up(args: argparse.Namespace) -> int:
+    """Run docker compose: start API + UI; create zenoh + noVNC containers without starting them."""
+    config_path = _packaged_config_path()
+    if not config_path.is_file():
+        print(f"Bundled config not found: {config_path}", file=sys.stderr)
+        return 1
+    compose_path = _docker_dir() / "docker-compose.yml"
+    if not compose_path.is_file():
+        print(f"Compose file not found: {compose_path}", file=sys.stderr)
+        return 1
+    env = os.environ.copy()
+    env["CYCLO_MANAGER_CONFIG_FILE"] = str(config_path)
+    base = ["docker", "compose", "-f", str(compose_path)]
+    try:
+        if args.pull:
+            subprocess.run([*base, "pull"], env=env, check=True)
+        subprocess.run([*base, "up", "-d", *COMPOSE_SERVICES_UP], env=env, check=True)
+        subprocess.run(
+            [*base, "create", "--no-recreate", *COMPOSE_SERVICES_CREATE_ONLY],
+            env=env,
+            check=True,
+        )
+    except subprocess.CalledProcessError as e:
+        return e.returncode
+    except FileNotFoundError:
+        print(
+            "Docker not found. Install Docker and ensure 'docker compose' is available.",
+            file=sys.stderr,
+        )
+        return 1
+    print("cyclo_manager stack is up (API + UI running; zenoh_daemon + novnc-server created, not started).")
+    return 0
+
+
+def cmd_down(args: argparse.Namespace) -> int:
+    """Stop cyclo_manager server, cyclo_manager_ui, and zenoh daemon (docker compose down)."""
+    compose_path = _docker_dir() / "docker-compose.yml"
+    if not compose_path.is_file():
+        print(f"Compose file not found: {compose_path}", file=sys.stderr)
+        return 1
+    env = os.environ.copy()
+    env["CYCLO_MANAGER_CONFIG_FILE"] = str(_packaged_config_path())
+    cmd = [
+        "docker",
+        "compose",
+        "-f",
+        str(compose_path),
+        "down",
+    ]
+    try:
+        subprocess.run(cmd, env=env, check=True)
+    except subprocess.CalledProcessError as e:
+        return e.returncode
+    except FileNotFoundError:
+        print(
+            "Docker not found. Install Docker and ensure 'docker compose' is available.",
+            file=sys.stderr,
+        )
+        return 1
+    print("cyclo_manager server, cyclo_manager_ui, and zenoh daemon are down.")
+    return 0
+
+
+def cmd_update(args: argparse.Namespace) -> int:
+    """Down containers, pip install -U cyclo-manager, then up again."""
+    cyclo_manager_exe = shutil.which("cyclo_manager")
+    if not cyclo_manager_exe:
+        print("cyclo_manager command not found in PATH.", file=sys.stderr)
+        return 1
+    pip_exe = shutil.which("pip3") or shutil.which("pip")
+    if not pip_exe:
+        print("pip not found; cannot update package.", file=sys.stderr)
+        return 1
+
+    print("Stopping containers (cyclo_manager down)...")
+    try:
+        subprocess.run([cyclo_manager_exe, "down"], check=True)
+    except subprocess.CalledProcessError as e:
+        return e.returncode
+
+    print(f"Updating {PYPI_PACKAGE} (pip install -U)...")
+    try:
+        subprocess.run(
+            [pip_exe, "install", "-U", PYPI_PACKAGE],
+            check=True,
+            timeout=120,
+        )
+    except subprocess.CalledProcessError as e:
+        print(f"pip install -U {PYPI_PACKAGE} failed.", file=sys.stderr)
+        return e.returncode
+    except subprocess.TimeoutExpired:
+        print("pip install timed out.", file=sys.stderr)
+        return 1
+
+    print("Starting containers (cyclo_manager up)...")
+    up_args = [cyclo_manager_exe, "up"]
+    if getattr(args, "pull", False):
+        up_args.append("--pull")
+    try:
+        subprocess.run(up_args, check=True)
+    except subprocess.CalledProcessError as e:
+        return e.returncode
+
+    print("cyclo_manager update completed.")
+    return 0
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(
+        prog="cyclo_manager",
+        description="cyclo_manager CLI: launch cyclo_manager server and UI containers. Services run via Docker images.",
+    )
+    sub = parser.add_subparsers(dest="command", help="Commands")
+
+    up_parser = sub.add_parser("up", help="Start cyclo_manager stack (docker compose)")
+    up_parser.add_argument(
+        "--pull",
+        action="store_true",
+        help="Pull all service images before create/up",
+    )
+    up_parser.set_defaults(func=cmd_up)
+
+    down_parser = sub.add_parser("down", help="Stop all stack containers (docker compose down)")
+    down_parser.set_defaults(func=cmd_down)
+
+    update_parser = sub.add_parser(
+        "update",
+        help="Down containers, pip install -U cyclo-manager, then up again",
+    )
+    update_parser.add_argument(
+        "--pull",
+        action="store_true",
+        help="Always pull images when running cyclo_manager up",
+    )
+    update_parser.set_defaults(func=cmd_update)
+
+    args = parser.parse_args()
+    if not args.command:
+        parser.print_help()
+        return 0
+    return args.func(args)

cyclo_manager-0.1.0/cyclo_manager_cli/config/config.yml

@@ -0,0 +1,10 @@
+# cyclo_manager Configuration
+# This file defines the containers that cyclo_manager can control.
+#
+# Services are discovered dynamically from each agent.
+
+containers:
+  ai_worker:
+    socket_path: "/agents/ai_worker/s6_agent.sock"
+  physical_ai_server:
+    socket_path: "/agents/physical_ai_server/s6_agent.sock"

cyclo_manager-0.1.0/cyclo_manager_cli/docker/docker-compose.yml

@@ -0,0 +1,54 @@
+# Packaged compose for pip-installed cyclo_manager_cli.
+# Uses pre-built images; config path is set via CYCLO_MANAGER_CONFIG_FILE by the CLI.
+# `cyclo_manager up` starts cyclo_manager + ui only; rmw_zenoh + novnc-server are created but left stopped.
+services:
+  rmw_zenoh:
+    container_name: zenoh_daemon
+    image: robotis/zenoh-daemon:latest
+    restart: always
+    network_mode: host
+    init: true
+
+  cyclo_manager:
+    container_name: cyclo_manager
+    image: robotis/cyclo-manager:0.1.0
+    restart: always
+    network_mode: host
+    volumes:
+      - /dev:/dev
+      - /dev/shm:/dev/shm
+      - /var/run/robotis/agent_sockets:/agents # For agent socket access
+      - ${CYCLO_MANAGER_CONFIG_FILE}:/app/config.yml # For hot-reload on config changes
+      - /var/run/docker.sock:/var/run/docker.sock # For Docker API access
+    environment:
+      - CONFIG_FILE=/app/config.yml
+
+  ui:
+    container_name: cyclo_manager_ui
+    image: robotis/cyclo-manager-ui:0.1.0
+    restart: always
+    network_mode: host
+    environment:
+      - NEXT_PUBLIC_API_URL=http://127.0.0.1:8081
+      - NODE_ENV=production
+
+  novnc-server:
+    container_name: novnc-server
+    image: robotis/novnc-server:latest
+    restart: always
+    cap_add:
+      - SYS_NICE
+    ulimits:
+      rtprio: 99
+      rttime: -1
+      memlock: 8428281856
+    network_mode: host
+    environment:
+      - DISPLAY=:99
+      - DISPLAY_WIDTH=1920
+      - DISPLAY_HEIGHT=1080
+      - WEBSOCKIFY_PORT=8090
+    volumes:
+      - /dev:/dev
+      - /dev/shm:/dev/shm
+    privileged: true

cyclo_manager-0.1.0/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "cyclo-manager"
+version = "0.1.0"
+description = "cyclo_manager CLI: pip-installable launcher for cyclo_manager server and UI containers. Run 'cyclo_manager up' to start Docker stack."
+readme = "README.md"
+license = "Apache-2.0"
+requires-python = ">=3.10"
+dependencies = []
+
+[project.optional-dependencies]
+dev = [
+    "pytest",
+    "ruff",
+]
+
+[project.scripts]
+cyclo_manager = "cyclo_manager_cli.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["cyclo_manager_cli*"]
+
+[tool.setuptools.package-data]
+cyclo_manager_cli = ["docker/*.yml", "docker/*.yaml", "config/*.yml", "config/*.yaml"]

cyclo_manager-0.1.0/setup.cfg

@@ -0,0 +1,9 @@
+[metadata]
+name = cyclo-manager
+version = 0.1.0
+
+[egg_info]
+egg_base = .
+tag_build = 
+tag_date = 0
+