cyclo-manager 0.1.0.dev2__tar.gz

cyclo_manager-0.1.0.dev2/PKG-INFO

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: cyclo-manager
+Version: 0.1.0.dev2
+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
+
+`cyclo-manager` is a small **pip-installable CLI** that brings up the cyclo_manager stack using **Docker Compose v2**. It runs the packaged [`docker-compose.yml`](cyclo_manager_cli/docker/docker-compose.yml): starts the API and web UI, **creates** (but does not start) optional Zenoh and noVNC containers, and can **self-update** via PyPI.
+
+The console script name is **`cyclo_manager`** (underscore).
+
+## Prerequisites
+
+- **Docker** with **Compose v2** (`docker compose`, not only legacy `docker-compose`)
+- **Python 3.10+**
+- For **`cyclo_manager update`**: **`pip`** / **`pip3`** on `PATH`
+
+## Installation
+
+Build and install a wheel (package name on PyPI / `pyproject.toml` is **`cyclo-manager`**):
+
+```bash
+python -m build --wheel
+pip install dist/cyclo_manager-*.whl
+```
+
+If `cyclo_manager` is not found, add the user scripts directory to `PATH`:
+
+```bash
+export PATH="$HOME/.local/bin:$PATH"
+```
+
+After install, use the CLI by name:
+
+```bash
+cyclo_manager --help
+cyclo_manager up
+```
+
+(If the script is still missing from `PATH`, you can run the same subcommands via `python3 -m cyclo_manager_cli.cli`, e.g. `python3 -m cyclo_manager_cli.cli up`.)
+
+## Commands
+
+| Command | What it does |
+|--------|----------------|
+| `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** |
+| `cyclo_manager up -c /path/to/config.yml` | Same as `up`, but mounts this file into the API container as config. If the path does not exist, the CLI **copies** the bundled default config there first |
+| `cyclo_manager up -r 35` | Sets **`ROS_DOMAIN_ID`** for the stack (default: **30**) |
+| `cyclo_manager up --pull` | Runs `docker compose pull` before up/create |
+| `cyclo_manager down` | `docker compose down` for the **packaged** compose file (stops/removes containers for that project) |
+| `cyclo_manager update` | Runs `cyclo_manager down`, then `pip install -U cyclo-manager`, then `cyclo_manager up` again (optional `-c`, `-r`, `--pull` are forwarded to `up`) |
+| `cyclo_manager --help` | Top-level help |
+
+Implementation reference: [`cyclo_manager_cli/cli.py`](cyclo_manager_cli/cli.py).
+
+### Compose services vs container names
+
+| Compose service | Typical container name | `up` behavior |
+|-----------------|------------------------|---------------|
+| `cyclo_manager` | `cyclo_manager` | Started |
+| `ui` | `cyclo_manager_ui` | Started |
+| `rmw_zenoh` | `zenoh_daemon` | **Created only** (start from Control UI or `docker start zenoh_daemon`) |
+| `novnc-server` | `novnc-server` | **Created only** (start when needed, e.g. `docker start novnc-server`) |
+
+### Environment passed into Compose
+
+- **`CYCLO_MANAGER_CONFIG_FILE`**: absolute path to the YAML config used on the host (default: bundled [`config/config.yml`](cyclo_manager_cli/config/config.yml))
+- **`ROS_DOMAIN_ID`**: from `-r` / `--ros-domain-id` (default **30**)
+
+`cyclo_manager down` always sets `CYCLO_MANAGER_CONFIG_FILE` to the **bundled** config path when invoking Compose (see `cmd_down` in `cli.py`).
+
+## Bundled config
+
+Default file: [`cyclo_manager_cli/config/config.yml`](cyclo_manager_cli/config/config.yml).
+
+It lists **managed containers** and **agent Unix socket paths** (host paths mounted under `/agents` in the API container), for example:
+
+- `ai_worker` → `/agents/ai_worker/s6_agent.sock`
+- `physical_ai_server` → `/agents/physical_ai_server/s6_agent.sock`
+
+Service names inside each container come from the agent, not from this file.
+
+## URLs (packaged compose, `network_mode: host`)
+
+After `cyclo_manager up`:
+
+| Service | URL |
+|---------|-----|
+| cyclo_manager API | http://127.0.0.1:8081 |
+| OpenAPI docs | http://127.0.0.1:8081/docs |
+| Web UI | http://127.0.0.1:3000 |
+
+Images and tags are defined in [`docker/docker-compose.yml`](cyclo_manager_cli/docker/docker-compose.yml) (e.g. `robotis/cyclo-manager`, `robotis/cyclo-manager-ui`).
+
+## Development from the repository root
+
+To run against **local** images and mounts (not the pip-bundled compose), use the root compose and config — see the main [project README](../README.md) and `docker-compose.dev.yml`.
+
+## Dependencies
+
+The CLI package itself declares **no** Python dependencies (`pyproject.toml`); it shells out to **`docker compose`** and optionally **`pip`**.

cyclo_manager-0.1.0.dev2/README.md

@@ -0,0 +1,96 @@
+# cyclo_manager CLI
+
+`cyclo-manager` is a small **pip-installable CLI** that brings up the cyclo_manager stack using **Docker Compose v2**. It runs the packaged [`docker-compose.yml`](cyclo_manager_cli/docker/docker-compose.yml): starts the API and web UI, **creates** (but does not start) optional Zenoh and noVNC containers, and can **self-update** via PyPI.
+
+The console script name is **`cyclo_manager`** (underscore).
+
+## Prerequisites
+
+- **Docker** with **Compose v2** (`docker compose`, not only legacy `docker-compose`)
+- **Python 3.10+**
+- For **`cyclo_manager update`**: **`pip`** / **`pip3`** on `PATH`
+
+## Installation
+
+Build and install a wheel (package name on PyPI / `pyproject.toml` is **`cyclo-manager`**):
+
+```bash
+python -m build --wheel
+pip install dist/cyclo_manager-*.whl
+```
+
+If `cyclo_manager` is not found, add the user scripts directory to `PATH`:
+
+```bash
+export PATH="$HOME/.local/bin:$PATH"
+```
+
+After install, use the CLI by name:
+
+```bash
+cyclo_manager --help
+cyclo_manager up
+```
+
+(If the script is still missing from `PATH`, you can run the same subcommands via `python3 -m cyclo_manager_cli.cli`, e.g. `python3 -m cyclo_manager_cli.cli up`.)
+
+## Commands
+
+| Command | What it does |
+|--------|----------------|
+| `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** |
+| `cyclo_manager up -c /path/to/config.yml` | Same as `up`, but mounts this file into the API container as config. If the path does not exist, the CLI **copies** the bundled default config there first |
+| `cyclo_manager up -r 35` | Sets **`ROS_DOMAIN_ID`** for the stack (default: **30**) |
+| `cyclo_manager up --pull` | Runs `docker compose pull` before up/create |
+| `cyclo_manager down` | `docker compose down` for the **packaged** compose file (stops/removes containers for that project) |
+| `cyclo_manager update` | Runs `cyclo_manager down`, then `pip install -U cyclo-manager`, then `cyclo_manager up` again (optional `-c`, `-r`, `--pull` are forwarded to `up`) |
+| `cyclo_manager --help` | Top-level help |
+
+Implementation reference: [`cyclo_manager_cli/cli.py`](cyclo_manager_cli/cli.py).
+
+### Compose services vs container names
+
+| Compose service | Typical container name | `up` behavior |
+|-----------------|------------------------|---------------|
+| `cyclo_manager` | `cyclo_manager` | Started |
+| `ui` | `cyclo_manager_ui` | Started |
+| `rmw_zenoh` | `zenoh_daemon` | **Created only** (start from Control UI or `docker start zenoh_daemon`) |
+| `novnc-server` | `novnc-server` | **Created only** (start when needed, e.g. `docker start novnc-server`) |
+
+### Environment passed into Compose
+
+- **`CYCLO_MANAGER_CONFIG_FILE`**: absolute path to the YAML config used on the host (default: bundled [`config/config.yml`](cyclo_manager_cli/config/config.yml))
+- **`ROS_DOMAIN_ID`**: from `-r` / `--ros-domain-id` (default **30**)
+
+`cyclo_manager down` always sets `CYCLO_MANAGER_CONFIG_FILE` to the **bundled** config path when invoking Compose (see `cmd_down` in `cli.py`).
+
+## Bundled config
+
+Default file: [`cyclo_manager_cli/config/config.yml`](cyclo_manager_cli/config/config.yml).
+
+It lists **managed containers** and **agent Unix socket paths** (host paths mounted under `/agents` in the API container), for example:
+
+- `ai_worker` → `/agents/ai_worker/s6_agent.sock`
+- `physical_ai_server` → `/agents/physical_ai_server/s6_agent.sock`
+
+Service names inside each container come from the agent, not from this file.
+
+## URLs (packaged compose, `network_mode: host`)
+
+After `cyclo_manager up`:
+
+| Service | URL |
+|---------|-----|
+| cyclo_manager API | http://127.0.0.1:8081 |
+| OpenAPI docs | http://127.0.0.1:8081/docs |
+| Web UI | http://127.0.0.1:3000 |
+
+Images and tags are defined in [`docker/docker-compose.yml`](cyclo_manager_cli/docker/docker-compose.yml) (e.g. `robotis/cyclo-manager`, `robotis/cyclo-manager-ui`).
+
+## Development from the repository root
+
+To run against **local** images and mounts (not the pip-bundled compose), use the root compose and config — see the main [project README](../README.md) and `docker-compose.dev.yml`.
+
+## Dependencies
+
+The CLI package itself declares **no** Python dependencies (`pyproject.toml`); it shells out to **`docker compose`** and optionally **`pip`**.

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

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: cyclo-manager
+Version: 0.1.0.dev2
+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
+
+`cyclo-manager` is a small **pip-installable CLI** that brings up the cyclo_manager stack using **Docker Compose v2**. It runs the packaged [`docker-compose.yml`](cyclo_manager_cli/docker/docker-compose.yml): starts the API and web UI, **creates** (but does not start) optional Zenoh and noVNC containers, and can **self-update** via PyPI.
+
+The console script name is **`cyclo_manager`** (underscore).
+
+## Prerequisites
+
+- **Docker** with **Compose v2** (`docker compose`, not only legacy `docker-compose`)
+- **Python 3.10+**
+- For **`cyclo_manager update`**: **`pip`** / **`pip3`** on `PATH`
+
+## Installation
+
+Build and install a wheel (package name on PyPI / `pyproject.toml` is **`cyclo-manager`**):
+
+```bash
+python -m build --wheel
+pip install dist/cyclo_manager-*.whl
+```
+
+If `cyclo_manager` is not found, add the user scripts directory to `PATH`:
+
+```bash
+export PATH="$HOME/.local/bin:$PATH"
+```
+
+After install, use the CLI by name:
+
+```bash
+cyclo_manager --help
+cyclo_manager up
+```
+
+(If the script is still missing from `PATH`, you can run the same subcommands via `python3 -m cyclo_manager_cli.cli`, e.g. `python3 -m cyclo_manager_cli.cli up`.)
+
+## Commands
+
+| Command | What it does |
+|--------|----------------|
+| `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** |
+| `cyclo_manager up -c /path/to/config.yml` | Same as `up`, but mounts this file into the API container as config. If the path does not exist, the CLI **copies** the bundled default config there first |
+| `cyclo_manager up -r 35` | Sets **`ROS_DOMAIN_ID`** for the stack (default: **30**) |
+| `cyclo_manager up --pull` | Runs `docker compose pull` before up/create |
+| `cyclo_manager down` | `docker compose down` for the **packaged** compose file (stops/removes containers for that project) |
+| `cyclo_manager update` | Runs `cyclo_manager down`, then `pip install -U cyclo-manager`, then `cyclo_manager up` again (optional `-c`, `-r`, `--pull` are forwarded to `up`) |
+| `cyclo_manager --help` | Top-level help |
+
+Implementation reference: [`cyclo_manager_cli/cli.py`](cyclo_manager_cli/cli.py).
+
+### Compose services vs container names
+
+| Compose service | Typical container name | `up` behavior |
+|-----------------|------------------------|---------------|
+| `cyclo_manager` | `cyclo_manager` | Started |
+| `ui` | `cyclo_manager_ui` | Started |
+| `rmw_zenoh` | `zenoh_daemon` | **Created only** (start from Control UI or `docker start zenoh_daemon`) |
+| `novnc-server` | `novnc-server` | **Created only** (start when needed, e.g. `docker start novnc-server`) |
+
+### Environment passed into Compose
+
+- **`CYCLO_MANAGER_CONFIG_FILE`**: absolute path to the YAML config used on the host (default: bundled [`config/config.yml`](cyclo_manager_cli/config/config.yml))
+- **`ROS_DOMAIN_ID`**: from `-r` / `--ros-domain-id` (default **30**)
+
+`cyclo_manager down` always sets `CYCLO_MANAGER_CONFIG_FILE` to the **bundled** config path when invoking Compose (see `cmd_down` in `cli.py`).
+
+## Bundled config
+
+Default file: [`cyclo_manager_cli/config/config.yml`](cyclo_manager_cli/config/config.yml).
+
+It lists **managed containers** and **agent Unix socket paths** (host paths mounted under `/agents` in the API container), for example:
+
+- `ai_worker` → `/agents/ai_worker/s6_agent.sock`
+- `physical_ai_server` → `/agents/physical_ai_server/s6_agent.sock`
+
+Service names inside each container come from the agent, not from this file.
+
+## URLs (packaged compose, `network_mode: host`)
+
+After `cyclo_manager up`:
+
+| Service | URL |
+|---------|-----|
+| cyclo_manager API | http://127.0.0.1:8081 |
+| OpenAPI docs | http://127.0.0.1:8081/docs |
+| Web UI | http://127.0.0.1:3000 |
+
+Images and tags are defined in [`docker/docker-compose.yml`](cyclo_manager_cli/docker/docker-compose.yml) (e.g. `robotis/cyclo-manager`, `robotis/cyclo-manager-ui`).
+
+## Development from the repository root
+
+To run against **local** images and mounts (not the pip-bundled compose), use the root compose and config — see the main [project README](../README.md) and `docker-compose.dev.yml`.
+
+## Dependencies
+
+The CLI package itself declares **no** Python dependencies (`pyproject.toml`); it shells out to **`docker compose`** and optionally **`pip`**.

cyclo_manager-0.1.0.dev2/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.dev2/cyclo_manager.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

cyclo_manager-0.1.0.dev2/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.dev2/cyclo_manager.egg-info/requires.txt

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

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

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

cyclo_manager-0.1.0.dev2/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.dev2"

cyclo_manager-0.1.0.dev2/cyclo_manager_cli/cli.py

@@ -0,0 +1,211 @@
+"""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 by default for cyclo_manager up."""
+    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."""
+    if args.config is None:
+        config_path = _packaged_config_path()
+    else:
+        config_path = Path(args.config).expanduser().resolve()
+        if not config_path.exists():
+            config_path.parent.mkdir(parents=True, exist_ok=True)
+            shutil.copy2(_packaged_config_path(), config_path)
+            print(f"Created default config at {config_path}", file=sys.stderr)
+        if not config_path.is_file():
+            print(f"Config file 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)
+    env["ROS_DOMAIN_ID"] = str(args.ros_domain_id)
+    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, "config", None) is not None:
+        up_args.extend(["-c", str(args.config)])
+    if getattr(args, "pull", False):
+        up_args.append("--pull")
+    if getattr(args, "ros_domain_id", None) is not None:
+        up_args.extend(["-r", str(args.ros_domain_id)])
+    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(
+        "-c",
+        "--config",
+        metavar="PATH",
+        help="Config file path (default: use bundled config from package)",
+    )
+    up_parser.add_argument(
+        "-r",
+        "--ros-domain-id",
+        type=int,
+        default=30,
+        metavar="ID",
+        help="ROS2 domain ID for cyclo_manager server (default: 30)",
+    )
+    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(
+        "-c",
+        "--config",
+        metavar="PATH",
+        help="Config file path for cyclo_manager up (default: use bundled config)",
+    )
+    update_parser.add_argument(
+        "-r",
+        "--ros-domain-id",
+        type=int,
+        default=30,
+        metavar="ID",
+        help="ROS2 domain ID for cyclo_manager up (default: 30)",
+    )
+    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.dev2/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.dev2/cyclo_manager_cli/docker/docker-compose.yml

@@ -0,0 +1,56 @@
+# 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
+      - ROS_DOMAIN_ID=${ROS_DOMAIN_ID:-30}
+
+  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:
+      - ROS_DOMAIN_ID=${ROS_DOMAIN_ID:-30}
+      - 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.dev2/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.dev2"
+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.dev2/setup.cfg

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