flwr 1.23.0__py3-none-any.whl → 1.25.0__py3-none-any.whl

flwr/cli/run/run.py

@@ -20,7 +20,7 @@ import io
 import json
 import subprocess
 from pathlib import Path
-from typing import Annotated, Any, Optional, cast
+from typing import Annotated, Any, cast
 
 import typer
 from rich.console import Console
@@ -45,6 +45,8 @@ from flwr.common.serde import config_record_to_proto, fab_to_proto, user_config_
 from flwr.common.typing import Fab
 from flwr.proto.control_pb2 import StartRunRequest  # pylint: disable=E0611
 from flwr.proto.control_pb2_grpc import ControlStub
+from flwr.supercore.constant import NOOP_FEDERATION
+from flwr.supercore.utils import parse_app_spec
 
 from ..log import start_stream
 from ..utils import flwr_cli_grpc_exc_handler, init_channel, load_cli_auth_plugin
@@ -52,18 +54,18 @@ from ..utils import flwr_cli_grpc_exc_handler, init_channel, load_cli_auth_plugi
 CONN_REFRESH_PERIOD = 60  # Connection refresh period for log streaming (seconds)
 
 
-# pylint: disable-next=too-many-locals, R0913, R0917
+# pylint: disable-next=too-many-locals, too-many-branches, R0913, R0917
 def run(
     app: Annotated[
         Path,
         typer.Argument(help="Path of the Flower App to run."),
     ] = Path("."),
     federation: Annotated[
-        Optional[str],
+        str | None,
         typer.Argument(help="Name of the federation to run the app on."),
     ] = None,
     run_config_overrides: Annotated[
-        Optional[list[str]],
+        list[str] | None,
         typer.Option(
             "--run-config",
             "-c",
@@ -71,7 +73,7 @@ def run(
         ),
     ] = None,
     federation_config_overrides: Annotated[
-        Optional[list[str]],
+        list[str] | None,
         typer.Option(
             "--federation-config",
             help=FEDERATION_CONFIG_HELP_MESSAGE,
@@ -100,11 +102,32 @@ def run(
     try:
         if suppress_output:
             redirect_output(captured_output)
+
+        # Determine if app is remote
+        app_spec = None
+        if (app_str := str(app)).startswith("@"):
+            # Validate app version and ID format
+            try:
+                _ = parse_app_spec(app_str)
+            except ValueError as e:
+                typer.secho(f"❌ {e}", fg=typer.colors.RED, err=True)
+                raise typer.Exit(code=1) from e
+
+            app_spec = app_str
+            # Set `app` to current directory for credential storage
+            app = Path(".")
+        is_remote_app = app_spec is not None
+
         typer.secho("Loading project configuration... ", fg=typer.colors.BLUE)
 
-        pyproject_path = app / "pyproject.toml" if app else None
-        config, errors, warnings = load_and_validate(path=pyproject_path)
+        # Disable the validation for remote apps
+        pyproject_path = app / "pyproject.toml" if not is_remote_app else None
+        # `./pyproject.toml` will be loaded when `pyproject_path` is None
+        config, errors, warnings = load_and_validate(
+            pyproject_path, check_module=not is_remote_app
+        )
         config = process_loaded_project_config(config, errors, warnings)
+
         federation, federation_config = validate_federation_in_project_config(
             federation, config, federation_config_overrides
         )
@@ -117,6 +140,7 @@ def run(
                 run_config_overrides,
                 stream,
                 output_format,
+                app_spec,
             )
         else:
             _run_without_control_api(
@@ -132,6 +156,7 @@ def run(
                 f"{err}",
                 fg=typer.colors.RED,
                 bold=True,
+                err=True,
             )
     finally:
         if suppress_output:
@@ -144,22 +169,32 @@ def _run_with_control_api(
     app: Path,
     federation: str,
     federation_config: dict[str, Any],
-    config_overrides: Optional[list[str]],
+    config_overrides: list[str] | None,
     stream: bool,
     output_format: str,
+    app_spec: str | None,
 ) -> None:
     channel = None
+    is_remote_app = app_spec is not None
     try:
         auth_plugin = load_cli_auth_plugin(app, federation, federation_config)
         channel = init_channel(app, federation_config, auth_plugin)
         stub = ControlStub(channel)
 
-        fab_bytes = build_fab_from_disk(app)
-        fab_hash = hashlib.sha256(fab_bytes).hexdigest()
-        config = cast(dict[str, Any], load_toml(app / FAB_CONFIG_FILE))
-        fab_id, fab_version = get_metadata_from_config(config)
+        # Build FAB if local app
+        if not is_remote_app:
+            fab_bytes = build_fab_from_disk(app)
+            fab_hash = hashlib.sha256(fab_bytes).hexdigest()
+            config = cast(dict[str, Any], load_toml(app / FAB_CONFIG_FILE))
+            fab_id, fab_version = get_metadata_from_config(config)
+            fab = Fab(fab_hash, fab_bytes, {})
+        # Skip FAB build if remote app
+        else:
+            # Use empty values for FAB
+            fab_id = fab_version = fab_hash = ""
+            fab = Fab(fab_hash, b"", {})
 
-        fab = Fab(fab_hash, fab_bytes, {})
+        real_federation: str = federation_config.get("federation", NOOP_FEDERATION)
 
         # Construct a `ConfigRecord` out of a flattened `UserConfig`
         fed_config = flatten_dict(federation_config.get("options", {}))
@@ -168,7 +203,9 @@ def _run_with_control_api(
         req = StartRunRequest(
             fab=fab_to_proto(fab),
             override_config=user_config_to_proto(parse_config_args(config_overrides)),
+            federation=real_federation,
             federation_options=config_record_to_proto(c_record),
+            app_spec=app_spec or "",
         )
         with flwr_cli_grpc_exc_handler():
             res = stub.StartRun(req)
@@ -178,23 +215,27 @@ def _run_with_control_api(
                 f"🎊 Successfully started run {res.run_id}", fg=typer.colors.GREEN
             )
         else:
-            typer.secho("❌ Failed to start run", fg=typer.colors.RED)
+            typer.secho("❌ Failed to start run", fg=typer.colors.RED, err=True)
             raise typer.Exit(code=1)
 
         if output_format == CliOutputFormat.JSON:
-            run_output = json.dumps(
-                {
-                    "success": res.HasField("run_id"),
-                    "run-id": res.run_id if res.HasField("run_id") else None,
-                    "fab-id": fab_id,
-                    "fab-name": fab_id.rsplit("/", maxsplit=1)[-1],
-                    "fab-version": fab_version,
-                    "fab-hash": fab_hash[:8],
-                    "fab-filename": get_fab_filename(config, fab_hash),
-                }
-            )
+            # Only include FAB metadata if we actually built a local FAB
+            payload: dict[str, Any] = {
+                "success": res.HasField("run_id"),
+                "run-id": f"{res.run_id}" if res.HasField("run_id") else None,
+            }
+            if not is_remote_app:
+                payload.update(
+                    {
+                        "fab-id": fab_id,
+                        "fab-name": fab_id.rsplit("/", maxsplit=1)[-1],
+                        "fab-version": fab_version,
+                        "fab-hash": fab_hash[:8],
+                        "fab-filename": get_fab_filename(config, fab_hash),
+                    }
+                )
             restore_output()
-            Console().print_json(run_output)
+            Console().print_json(json.dumps(payload))
 
         if stream:
             start_stream(res.run_id, channel, CONN_REFRESH_PERIOD)
@@ -204,14 +245,14 @@ def _run_with_control_api(
 
 
 def _run_without_control_api(
-    app: Optional[Path],
+    app: Path | None,
     federation_config: dict[str, Any],
-    config_overrides: Optional[list[str]],
+    config_overrides: list[str] | None,
     federation: str,
 ) -> None:
     try:
         num_supernodes = federation_config["options"]["num-supernodes"]
-        verbose: Optional[bool] = federation_config["options"].get("verbose")
+        verbose: bool | None = federation_config["options"].get("verbose")
         backend_cfg = federation_config["options"].get("backend", {})
     except KeyError as err:
         typer.secho(
@@ -222,6 +263,7 @@ def _run_without_control_api(
             "options.num-supernodes = 10\n",
             fg=typer.colors.RED,
             bold=True,
+            err=True,
         )
         raise typer.Exit(code=1) from err
 

flwr/cli/run_utils.py

@@ -0,0 +1,148 @@
+# Copyright 2025 Flower Labs GmbH. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ==============================================================================
+"""Flower command line interface utils."""
+
+
+from dataclasses import dataclass
+from datetime import datetime, timedelta
+
+from flwr.common.date import isoformat8601_utc
+from flwr.common.typing import Run
+
+
+@dataclass
+class RunRow:  # pylint: disable=too-many-instance-attributes
+    """Represents a single run's data for display.
+
+    Attributes
+    ----------
+    run_id : int
+        The unique identifier for the run.
+    federation : str
+        The federation name.
+    fab_id : str
+        The Flower App Bundle identifier.
+    fab_version : str
+        The FAB version string.
+    fab_hash : str
+        The SHA-256 hash of the FAB.
+    status_text : str
+        The formatted status text.
+    elapsed : float
+        The elapsed time in seconds.
+    pending_at : str
+        Timestamp when run entered pending state.
+    starting_at : str
+        Timestamp when run entered starting state.
+    running_at : str
+        Timestamp when run entered running state.
+    finished_at : str
+        Timestamp when run finished.
+    network_traffic_inbound : int
+        The total inbound network traffic (in bytes) used during the run.
+        It includes the traffic from SuperNodes to SuperLink.
+    network_traffic_outbound : int
+        The total outbound network traffic (in bytes) used during the run.
+        It includes the traffic from SuperLink to SuperNodes.
+    compute_time_serverapp : float
+        The total compute time (in seconds) of the ServerApp during the run.
+    compute_time_clientapp : float
+        The total compute time (in seconds) of all ClientApps during the run.
+    """
+
+    run_id: int
+    federation: str
+    fab_id: str
+    fab_version: str
+    fab_hash: str
+    status_text: str
+    elapsed: float
+    pending_at: str
+    starting_at: str
+    running_at: str
+    finished_at: str
+    network_traffic_inbound: int
+    network_traffic_outbound: int
+    compute_time_serverapp: float
+    compute_time_clientapp: float
+
+
+def format_runs(runs: list[Run], now_isoformat: str) -> list[RunRow]:
+    """Format runs to a list of RunRow objects.
+
+    Parameters
+    ----------
+    runs : list[Run]
+        List of Run objects to format.
+    now_isoformat : str
+        Current timestamp in ISO format for calculating elapsed time.
+
+    Returns
+    -------
+    list[RunRow]
+        List of formatted RunRow objects sorted by pending_at timestamp.
+    """
+
+    def _format_datetime(dt: datetime | None) -> str:
+        return isoformat8601_utc(dt).replace("T", " ") if dt else "N/A"
+
+    run_list: list[RunRow] = []
+
+    # Add rows
+    for run in sorted(runs, key=lambda x: datetime.fromisoformat(x.pending_at)):
+        # Combine status and sub-status into a single string
+        if run.status.sub_status == "":
+            status_text = run.status.status
+        else:
+            status_text = f"{run.status.status}:{run.status.sub_status}"
+
+        # Convert isoformat to datetime
+        pending_at = datetime.fromisoformat(run.pending_at) if run.pending_at else None
+        starting_at = (
+            datetime.fromisoformat(run.starting_at) if run.starting_at else None
+        )
+        running_at = datetime.fromisoformat(run.running_at) if run.running_at else None
+        finished_at = (
+            datetime.fromisoformat(run.finished_at) if run.finished_at else None
+        )
+
+        # Calculate elapsed time
+        elapsed_time = timedelta()
+        if running_at:
+            if finished_at:
+                end_time = finished_at
+            else:
+                end_time = datetime.fromisoformat(now_isoformat)
+            elapsed_time = end_time - running_at
+
+        row = RunRow(
+            run_id=run.run_id,
+            federation=run.federation,
+            fab_id=run.fab_id,
+            fab_version=run.fab_version,
+            fab_hash=run.fab_hash,
+            status_text=status_text,
+            elapsed=elapsed_time.total_seconds(),
+            pending_at=_format_datetime(pending_at),
+            starting_at=_format_datetime(starting_at),
+            running_at=_format_datetime(running_at),
+            finished_at=_format_datetime(finished_at),
+            network_traffic_inbound=run.bytes_recv,
+            network_traffic_outbound=run.bytes_sent,
+            compute_time_serverapp=elapsed_time.total_seconds(),
+            compute_time_clientapp=run.clientapp_runtime,
+        )
+        run_list.append(row)
+    return run_list

flwr/cli/stop.py

@@ -18,7 +18,7 @@
 import io
 import json
 from pathlib import Path
-from typing import Annotated, Optional
+from typing import Annotated
 
 import typer
 from rich.console import Console
@@ -51,11 +51,11 @@ def stop(  # pylint: disable=R0914
         typer.Argument(help="Path of the Flower project"),
     ] = Path("."),
     federation: Annotated[
-        Optional[str],
+        str | None,
         typer.Argument(help="Name of the federation"),
     ] = None,
     federation_config_overrides: Annotated[
-        Optional[list[str]],
+        list[str] | None,
         typer.Option(
             "--federation-config",
             help=FEDERATION_CONFIG_HELP_MESSAGE,
@@ -70,7 +70,11 @@ def stop(  # pylint: disable=R0914
         ),
     ] = CliOutputFormat.DEFAULT,
 ) -> None:
-    """Stop a run."""
+    """Stop a Flower run.
+
+    This command stops a running Flower App execution by sending a stop request to the
+    SuperLink via the Control API.
+    """
     suppress_output = output_format == CliOutputFormat.JSON
     captured_output = io.StringIO()
     try:
@@ -81,7 +85,7 @@ def stop(  # pylint: disable=R0914
         typer.secho("Loading project configuration... ", fg=typer.colors.BLUE)
 
         pyproject_path = app / FAB_CONFIG_FILE if app else None
-        config, errors, warnings = load_and_validate(path=pyproject_path)
+        config, errors, warnings = load_and_validate(pyproject_path, check_module=False)
         config = process_loaded_project_config(config, errors, warnings)
         federation, federation_config = validate_federation_in_project_config(
             federation, config, federation_config_overrides
@@ -101,6 +105,7 @@ def stop(  # pylint: disable=R0914
                 f"❌ {err}",
                 fg=typer.colors.RED,
                 bold=True,
+                err=True,
             )
             raise typer.Exit(code=1) from err
         finally:
@@ -116,6 +121,7 @@ def stop(  # pylint: disable=R0914
                 f"{err}",
                 fg=typer.colors.RED,
                 bold=True,
+                err=True,
             )
     finally:
         if suppress_output:
@@ -124,7 +130,17 @@ def stop(  # pylint: disable=R0914
 
 
 def _stop_run(stub: ControlStub, run_id: int, output_format: str) -> None:
-    """Stop a run."""
+    """Stop a run and display the result.
+
+    Parameters
+    ----------
+    stub : ControlStub
+        The gRPC stub for Control API communication.
+    run_id : int
+        The unique identifier of the run to stop.
+    output_format : str
+        Output format ('default' or 'json').
+    """
     with flwr_cli_grpc_exc_handler():
         response: StopRunResponse = stub.StopRun(request=StopRunRequest(run_id=run_id))
     if response.success:
@@ -133,10 +149,12 @@ def _stop_run(stub: ControlStub, run_id: int, output_format: str) -> None:
             run_output = json.dumps(
                 {
                     "success": True,
-                    "run-id": run_id,
+                    "run-id": f"{run_id}",
                 }
             )
             restore_output()
             Console().print_json(run_output)
     else:
-        typer.secho(f"❌ Run {run_id} couldn't be stopped.", fg=typer.colors.RED)
+        typer.secho(
+            f"❌ Run {run_id} couldn't be stopped.", fg=typer.colors.RED, err=True
+        )

flwr/cli/supernode/ls.py

@@ -19,7 +19,7 @@ import io
 import json
 from datetime import datetime, timedelta
 from pathlib import Path
-from typing import Annotated, Optional, cast
+from typing import Annotated, cast
 
 import typer
 from rich.console import Console
@@ -32,8 +32,8 @@ from flwr.cli.config_utils import (
     process_loaded_project_config,
     validate_federation_in_project_config,
 )
-from flwr.common.constant import FAB_CONFIG_FILE, NOOP_FLWR_AID, CliOutputFormat
-from flwr.common.date import format_timedelta, isoformat8601_utc
+from flwr.common.constant import FAB_CONFIG_FILE, NOOP_ACCOUNT_NAME, CliOutputFormat
+from flwr.common.date import isoformat8601_utc
 from flwr.common.logger import print_json_error, redirect_output, restore_output
 from flwr.proto.control_pb2 import (  # pylint: disable=E0611
     ListNodesRequest,
@@ -41,10 +41,11 @@ from flwr.proto.control_pb2 import (  # pylint: disable=E0611
 )
 from flwr.proto.control_pb2_grpc import ControlStub
 from flwr.proto.node_pb2 import NodeInfo  # pylint: disable=E0611
+from flwr.supercore.utils import humanize_duration
 
 from ..utils import flwr_cli_grpc_exc_handler, init_channel, load_cli_auth_plugin
 
-_NodeListType = tuple[int, str, str, str, str, str, str, str]
+_NodeListType = tuple[int, str, str, str, str, str, str, str, float]
 
 
 def ls(  # pylint: disable=R0914, R0913, R0917
@@ -54,7 +55,7 @@ def ls(  # pylint: disable=R0914, R0913, R0917
         typer.Argument(help="Path of the Flower project"),
     ] = Path("."),
     federation: Annotated[
-        Optional[str],
+        str | None,
         typer.Argument(help="Name of the federation"),
     ] = None,
     output_format: Annotated[
@@ -86,7 +87,7 @@ def ls(  # pylint: disable=R0914, R0913, R0917
         typer.secho("Loading project configuration... ", fg=typer.colors.BLUE)
 
         pyproject_path = app / FAB_CONFIG_FILE if app else None
-        config, errors, warnings = load_and_validate(path=pyproject_path)
+        config, errors, warnings = load_and_validate(pyproject_path, check_module=False)
         config = process_loaded_project_config(config, errors, warnings)
         federation, federation_config = validate_federation_in_project_config(
             federation, config
@@ -138,7 +139,7 @@ def _format_nodes(
 ) -> list[_NodeListType]:
     """Format node information for display."""
 
-    def _format_datetime(dt_str: Optional[str]) -> str:
+    def _format_datetime(dt_str: str | None) -> str:
         dt = datetime.fromisoformat(dt_str) if dt_str else None
         return isoformat8601_utc(dt).replace("T", " ") if dt else "N/A"
 
@@ -160,12 +161,13 @@ def _format_nodes(
             (
                 node.node_id,
                 node.owner_aid,
+                node.owner_name,
                 node.status,
                 _format_datetime(node.registered_at),
                 _format_datetime(node.last_activated_at),
                 _format_datetime(node.last_deactivated_at),
                 _format_datetime(node.unregistered_at),
-                format_timedelta(elapsed_time_activated),
+                elapsed_time_activated.total_seconds(),
             )
         )
 
@@ -188,7 +190,8 @@ def _to_table(nodes_info: list[_NodeListType], verbose: bool) -> Table:
     for row in nodes_info:
         (
             node_id,
-            owner_aid,
+            _,
+            owner_name,
             status,
             _,
             last_activated_at,
@@ -216,9 +219,17 @@ def _to_table(nodes_info: list[_NodeListType], verbose: bool) -> Table:
 
         formatted_row = (
             f"[bold]{node_id}[/bold]",
-            f"{owner_aid}" if owner_aid != NOOP_FLWR_AID else f"[dim]{owner_aid}[/dim]",
+            (
+                f"{owner_name}"
+                if owner_name != NOOP_ACCOUNT_NAME
+                else f"[dim]{owner_name}[/dim]"
+            ),
             f"[{status_style}]{status}",
-            f"[cyan]{elapse_activated}[/cyan]" if status == "online" else "",
+            (
+                f"[cyan]{humanize_duration(elapse_activated)}[/cyan]"
+                if status == "online"
+                else ""
+            ),
             time_at,
         )
         table.add_row(*formatted_row)
@@ -233,6 +244,7 @@ def _to_json(nodes_info: list[_NodeListType], verbose: bool) -> str:
         (
             node_id,
             owner_aid,
+            owner_name,
             status,
             created_at,
             activated_at,
@@ -246,8 +258,9 @@ def _to_json(nodes_info: list[_NodeListType], verbose: bool) -> str:
 
         nodes_list.append(
             {
-                "node-id": node_id,
+                "node-id": f"{node_id}",
                 "owner-aid": owner_aid,
+                "owner-name": owner_name,
                 "status": status,
                 "created-at": created_at,
                 "online-at": activated_at,

flwr/cli/supernode/register.py

@@ -18,7 +18,7 @@
 import io
 import json
 from pathlib import Path
-from typing import Annotated, Optional
+from typing import Annotated
 
 import typer
 from cryptography.exceptions import UnsupportedAlgorithm
@@ -57,7 +57,7 @@ def register(  # pylint: disable=R0914
         typer.Argument(help="Path of the Flower project"),
     ] = Path("."),
     federation: Annotated[
-        Optional[str],
+        str | None,
         typer.Argument(help="Name of the federation"),
     ] = None,
     output_format: Annotated[
@@ -85,7 +85,7 @@ def register(  # pylint: disable=R0914
         typer.secho("Loading project configuration... ", fg=typer.colors.BLUE)
 
         pyproject_path = app / FAB_CONFIG_FILE if app else None
-        config, errors, warnings = load_and_validate(path=pyproject_path)
+        config, errors, warnings = load_and_validate(pyproject_path, check_module=False)
         config = process_loaded_project_config(config, errors, warnings)
         federation, federation_config = validate_federation_in_project_config(
             federation, config
@@ -107,6 +107,7 @@ def register(  # pylint: disable=R0914
                 f"❌ {err}",
                 fg=typer.colors.RED,
                 bold=True,
+                err=True,
             )
             raise typer.Exit(code=1) from err
         finally:
@@ -123,6 +124,7 @@ def register(  # pylint: disable=R0914
                 f"{err}",
                 fg=typer.colors.RED,
                 bold=True,
+                err=True,
             )
     finally:
         if suppress_output:
@@ -151,7 +153,9 @@ def _register_node(stub: ControlStub, public_key: bytes, output_format: str) ->
             restore_output()
             Console().print_json(run_output)
     else:
-        typer.secho("❌ SuperNode couldn't be registered.", fg=typer.colors.RED)
+        typer.secho(
+            "❌ SuperNode couldn't be registered.", fg=typer.colors.RED, err=True
+        )
 
 
 def try_load_public_key(public_key_path: Path) -> bytes:
@@ -161,6 +165,7 @@ def try_load_public_key(public_key_path: Path) -> bytes:
             f"❌ Public key file '{public_key_path}' does not exist.",
             fg=typer.colors.RED,
             bold=True,
+            err=True,
         )
         raise typer.Exit(code=1)
 

flwr/cli/supernode/unregister.py

@@ -18,7 +18,7 @@
 import io
 import json
 from pathlib import Path
-from typing import Annotated, Optional
+from typing import Annotated
 
 import typer
 from rich.console import Console
@@ -49,7 +49,7 @@ def unregister(  # pylint: disable=R0914
         typer.Argument(help="Path of the Flower project"),
     ] = Path("."),
     federation: Annotated[
-        Optional[str],
+        str | None,
         typer.Argument(help="Name of the federation"),
     ] = None,
     output_format: Annotated[
@@ -73,7 +73,7 @@ def unregister(  # pylint: disable=R0914
         typer.secho("Loading project configuration... ", fg=typer.colors.BLUE)
 
         pyproject_path = app / FAB_CONFIG_FILE if app else None
-        config, errors, warnings = load_and_validate(path=pyproject_path)
+        config, errors, warnings = load_and_validate(pyproject_path, check_module=False)
         config = process_loaded_project_config(config, errors, warnings)
         federation, federation_config = validate_federation_in_project_config(
             federation, config
@@ -93,6 +93,7 @@ def unregister(  # pylint: disable=R0914
                 f"❌ {err}",
                 fg=typer.colors.RED,
                 bold=True,
+                err=True,
             )
             raise typer.Exit(code=1) from err
         finally:
@@ -109,6 +110,7 @@ def unregister(  # pylint: disable=R0914
                 f"{err}",
                 fg=typer.colors.RED,
                 bold=True,
+                err=True,
             )
     finally:
         if suppress_output: