152 simplify wireless tags (#171)

README.md

@@ -132,7 +132,6 @@ By default, the app runs in console mode for direct audio interaction. Use the `
 | `--local-vision` | `False` | Use local vision model (SmolVLM2) for periodic image processing instead of gpt-realtime vision. Requires `local_vision` extra to be installed. |
 | `--gradio` | `False` | Launch the Gradio web UI. Without this flag, runs in console mode. Required when running in simulation mode. |
 | `--debug` | `False` | Enable verbose logging for troubleshooting. |
-| `--wireless-version` | `False` | Use GStreamer backend for wireless version of the robot. Requires `reachy_mini_wireless` extra to be installed.
 
 
 ### Examples
@@ -148,16 +147,16 @@ By default, the app runs in console mode for direct audio interaction. Use the `
   reachy-mini-conversation-app --local-vision
   ```
 
-- Run with wireless support (requires `reachy_mini_wireless` extra and daemon started with `--wireless-version`):
+- Disable the camera pipeline (audio-only conversation):
 
   ```bash
-  reachy-mini-conversation-app --wireless-version
+  reachy-mini-conversation-app --no-camera
   ```
 
-- Disable the camera pipeline (audio-only conversation):
+- Run with Gradio web interface:
 
   ```bash
-  reachy-mini-conversation-app --no-camera
+  reachy-mini-conversation-app --gradio
   ```
 
 ### Troubleshooting
@@ -222,8 +221,6 @@ When running with `--gradio`, open the “Personality” accordion:
 Note: The “Personality” panel updates the conversation instructions. Tool sets are loaded at startup from `tools.txt` and are not hot‑reloaded.
 
 
-
-
 ## Development workflow
 - Install the dev group extras: `uv sync --group dev` or `pip install -e .[dev]`.
 - Run formatting and linting: `ruff check .`.

src/reachy_mini_conversation_app/main.py

@@ -18,6 +18,7 @@ from reachy_mini_conversation_app.utils import (
     parse_args,
     setup_logger,
     handle_vision_stuff,
+    log_connection_troubleshooting,
 )
 
 
@@ -52,31 +53,47 @@ def run(
     logger.info("Starting Reachy Mini Conversation App")
 
     if args.no_camera and args.head_tracker is not None:
-        logger.warning("Head tracking is not activated due to --no-camera.")
+        logger.warning(
+            "Head tracking disabled: --no-camera flag is set. "
+            "Remove --no-camera to enable head tracking."
+        )
 
     if robot is None:
-        # Initialize robot with appropriate backend
-        # TODO: Implement dynamic robot connection detection
-        # Automatically detect and connect to available Reachy Mini robot(s!)
-        # Priority checks (in order):
-        #   1. Reachy Lite connected directly to the host
-        #   2. Reachy Mini daemon running on localhost (same device)
-        #   3. Reachy Mini daemon on local network (same subnet)
-
-        if args.wireless_version and not args.on_device:
-            logger.info("Using WebRTC backend for fully remote wireless version")
-            robot = ReachyMini(media_backend="webrtc", localhost_only=False)
-        elif args.wireless_version and args.on_device:
-            logger.info("Using GStreamer backend for on-device wireless version")
-            robot = ReachyMini(media_backend="gstreamer")
-        else:
-            logger.info("Using default backend for lite version")
-            robot = ReachyMini(media_backend="default")
+        try:
+            robot_kwargs = {}
+            if args.robot_name is not None:
+                robot_kwargs["robot_name"] = args.robot_name
+
+            logger.info("Initializing ReachyMini (SDK will auto-detect appropriate backend)")
+            robot = ReachyMini(**robot_kwargs)
+
+        except TimeoutError as e:
+            logger.error(
+                "Connection timeout: Failed to connect to Reachy Mini daemon. "
+                f"Details: {e}"
+            )
+            log_connection_troubleshooting(logger, args.robot_name)
+            sys.exit(1)
+
+        except ConnectionError as e:
+            logger.error(
+                "Connection failed: Unable to establish connection to Reachy Mini. "
+                f"Details: {e}"
+            )
+            log_connection_troubleshooting(logger, args.robot_name)
+            sys.exit(1)
+
+        except Exception as e:
+            logger.error(
+                f"Unexpected error during robot initialization: {type(e).__name__}: {e}"
+            )
+            logger.error("Please check your configuration and try again.")
+            sys.exit(1)
 
     # Check if running in simulation mode without --gradio
     if robot.client.get_status()["simulation_enabled"] and not args.gradio:
         logger.error(
-            "Simulation mode requires Gradio interface. Please use --gradio flag when running in simulation mode.",
+            "Simulation mode requires Gradio interface. Please use --gradio flag when running in simulation mode."
         )
         robot.client.disconnect()
         sys.exit(1)

src/reachy_mini_conversation_app/utils.py

@@ -1,7 +1,7 @@
 import logging
 import argparse
 import warnings
-from typing import Any, Tuple
+from typing import Any, Tuple, Optional
 
 from reachy_mini import ReachyMini
 from reachy_mini_conversation_app.camera_worker import CameraWorker
@@ -26,16 +26,10 @@ def parse_args() -> Tuple[argparse.Namespace, list]:  # type: ignore
     parser.add_argument("--gradio", default=False, action="store_true", help="Open gradio interface")
     parser.add_argument("--debug", default=False, action="store_true", help="Enable debug logging")
     parser.add_argument(
-        "--wireless-version",
-        default=False,
-        action="store_true",
-        help="Use WebRTC backend for wireless version of the robot",
-    )
-    parser.add_argument(
-        "--on-device",
-        default=False,
-        action="store_true",
-        help="Use when conversation app is running on the same device as Reachy Mini daemon",
+        "--robot-name",
+        type=str,
+        default=None,
+        help="[Optional] Robot name/prefix for Zenoh topics (must match daemon's --robot-name). Only needed for development with multiple robots.",
     )
     return parser.parse_known_args()
 
@@ -108,3 +102,22 @@ def setup_logger(debug: bool) -> logging.Logger:
         logging.getLogger("fastrtc").setLevel(logging.ERROR)
         logging.getLogger("aioice").setLevel(logging.WARNING)
     return logger
+
+def log_connection_troubleshooting(logger: logging.Logger, robot_name: Optional[str]) -> None:
+    """Log troubleshooting steps for connection issues."""
+    logger.error("Troubleshooting steps:")
+    logger.error("  1. Verify reachy-mini-daemon is running")
+
+    if robot_name is not None:
+        logger.error(
+            f"  2. Daemon must be started with: --robot-name '{robot_name}'"
+        )
+    else:
+        logger.error(
+            "  2. If daemon uses --robot-name, add the same flag here: "
+            "--robot-name <name>"
+        )
+
+    logger.error("  3. For wireless: check network connectivity")
+    logger.error("  4. Review daemon logs")
+    logger.error("  5. Restart the daemon")