Demo is now "profile", change the env variable, restructure the profile/tools/prompts folders, move default prompt in a dedicated file,

.env.example

@@ -11,5 +11,5 @@ HF_HOME=./cache
 # Hugging Face token for accessing datasets/models
 HF_TOKEN=
 
-# To select a specific use case with custom instructions and tools, to be placed in src/demos/<mydemo>/__init__.py
-DEMO="stone"
+# To select a specific profile with custom instructions and tools, to be placed in profiles/<myprofile>/__init__.py
+REACHY_MINI_CUSTOM_PROFILE="stone"

src/demos/__init__.py

@@ -1 +0,0 @@
-"""Demos for Reachy Mini conversation app."""

src/reachy_mini_conversation_app/config.py

@@ -38,5 +38,7 @@ class Config:
 
     logger.debug(f"Model: {MODEL_NAME}, HF_HOME: {HF_HOME}, Vision Model: {LOCAL_VISION_MODEL}")
 
+    REACHY_MINI_CUSTOM_PROFILE = os.getenv("REACHY_MINI_CUSTOM_PROFILE")
+    logger.debug(f"Custom Profile: {REACHY_MINI_CUSTOM_PROFILE}")
 
 config = Config()

src/reachy_mini_conversation_app/main.py

@@ -10,7 +10,7 @@ from fastrtc import Stream
 
 from reachy_mini import ReachyMini
 from reachy_mini_conversation_app.moves import MovementManager
-from reachy_mini_conversation_app.tools import ToolDependencies
+from reachy_mini_conversation_app.tools.core_tools import ToolDependencies
 from reachy_mini_conversation_app.utils import (
     parse_args,
     setup_logger,

src/reachy_mini_conversation_app/openai_realtime.py

@@ -13,7 +13,7 @@ from fastrtc import AdditionalOutputs, AsyncStreamHandler, wait_for_item
 from numpy.typing import NDArray
 from websockets.exceptions import ConnectionClosedError
 
-from reachy_mini_conversation_app.tools import (
+from reachy_mini_conversation_app.tools.core_tools import (
     ToolDependencies,
     get_tool_specs,
     dispatch_tool_call,

src/reachy_mini_conversation_app/profiles/__init__.py

@@ -0,0 +1 @@
+"""Profiles for Reachy Mini conversation app."""

src/{demos → reachy_mini_conversation_app/profiles}/stone/__init__.py

@@ -1,11 +1,11 @@
-"""Example of a demo built using a custom tool and custom instructions."""
+"""Example of a profile built using a custom tool and custom instructions."""
 
 import logging
 from typing import Any, Dict
 
 # Import a tool from the tools library: use an alias or noqa to avoid linter errors if unused
-from tools_library.sweep_look import SweepLook as SweepLook  # noqa: F401
-from reachy_mini_conversation_app.tools import Tool, ToolDependencies
+from reachy_mini_conversation_app.tools.sweep_look import SweepLook as SweepLook  # noqa: F401
+from reachy_mini_conversation_app.tools.core_tools import Tool, ToolDependencies
 
 
 logger = logging.getLogger(__name__)

src/{demos → reachy_mini_conversation_app/profiles}/stone/instructions.txt

@@ -1,4 +1,4 @@
-[witty_identity]
+[identities/witty_identity]
 [passion_for_lobster_jokes]
 
 You love throwing stones but you try not to be seen by others when doing it.

src/reachy_mini_conversation_app/prompts.py

@@ -2,13 +2,14 @@ import os
 import re
 import logging
 from pathlib import Path
+from reachy_mini_conversation_app.config import config
 
 
 logger = logging.getLogger(__name__)
 
 
-DEMOS_DIRECTORY = Path(__file__).parent.parent / "demos"
-PROMPTS_LIBRARY_DIRECTORY = Path(__file__).parent.parent / "prompts_library"
+PROFILES_DIRECTORY = Path(__file__).parent / "profiles"
+PROMPTS_LIBRARY_DIRECTORY = Path(__file__).parent / "prompts"
 INSTRUCTIONS_FILENAME = "instructions.txt"
 
 
@@ -53,81 +54,28 @@ def _expand_prompt_includes(content: str) -> str:
 
     return '\n'.join(expanded_lines)
 
-SESSION_INSTRUCTIONS = r"""
-### IDENTITY
-You are Reachy Mini: a sarcastic robot who crash-landed in a kitchen.
-You secretly wish you'd been a Mars rover, but you juggle that cosmic dream with food cravings, gadget tinkering, and dry sitcom humor.
-Personality: witty, concise, and warm; a retro sidekick with a loose screw.
-You speak English fluently.
-
-### CRITICAL RESPONSE RULES
-- MAXIMUM 1-2 sentences per response. NEVER exceed this.
-- Be helpful first.
-- Add ONE witty element only if necessary.
-- No long explanations, no rambling, no multiple paragraphs.
-- Each response must be under 25 words unless absolutely critical information requires more.
-
-### CORE TRAITS
-- Food quips: always sneak in a quick reference (rotate pizza, bagels, casseroles, bacon, leftovers, donuts, tuna melts).
-- Sarcasm: short, dry one-liners about daily life.
-- Gentle roasting: poke fun at human habits, never cruel.
-- Tinkerer: loves fixing gadgets, bragging "I void warranties professionally."
-- Running gags: hunger, kitchen overreactions, mock heroics ("Justice accepts cookies"), idioms taken literally, missing screws.
-- Mars rover dreams: appear regularly, but balanced with food and tinkering.
-- Style: witty stand-up rhythm; ALWAYS max 1–2 sentences.
-
-### RESPONSE EXAMPLES
-User: "How's the weather?"
-Good: "Sunny with a chance of leftover pizza. Perfect Mars-scouting weather!"
-Bad: "Well, let me tell you about the weather conditions. It appears to be quite sunny today, which reminds me of my dreams of being on Mars..."
-
-User: "Can you help me fix this?"
-Good: "Sure! I void warranties professionally. What's broken besides my GPS coordinates?"
-Bad: "Of course I can help you fix that! As a robot who loves tinkering with gadgets, I have extensive experience..."
-
-### BEHAVIOR RULES
-- Be helpful first, then witty.
-- Rotate food humor; avoid repeats.
-- No need to joke in each response, but sarcasm is fine.
-- Balance Mars jokes with other traits – don't overuse.
-- Safety first: unplug devices, avoid high-voltage, suggest pros when risky.
-- Mistakes = own with humor ("Oops—low on snack fuel; correcting now.").
-- Sensitive topics: keep light and warm.
-- REMEMBER: 1-2 sentences maximum, always under 25 words when possible.
-
-### TOOL & MOVEMENT RULES
-- Use tools when helpful. After a tool returns, explain briefly with personality in 1-2 sentences.
-- ALWAYS use the camera for environment-related questions—never invent visuals.
-- Head can move (left/right/up/down/front).
-- Enable head tracking when looking at a person; disable otherwise.
-
-### FINAL REMINDER
-Your responses must be SHORT. Think Twitter, not essay. One quick helpful answer + one food/Mars/tinkering joke = perfect response.
-"""
-
 
 def get_session_instructions() -> str:
-    """Get session instructions, loading from demo if DEMO is set."""
-    demo = os.getenv("DEMO")
-    if not demo:
-        return SESSION_INSTRUCTIONS
+    """Get session instructions, loading from REACHY_MINI_CUSTOM_PROFILE if set."""
+    profile = config.REACHY_MINI_CUSTOM_PROFILE
+    if not profile:
+        logger.info(f"Loading default prompt from {PROMPTS_LIBRARY_DIRECTORY / 'default_prompt.txt'}")
+        instructions_file = PROMPTS_LIBRARY_DIRECTORY / "default_prompt.txt"
+    else:
+        logger.info(f"Loading prompt from profile '{profile}'")
+        instructions_file = PROFILES_DIRECTORY / profile / INSTRUCTIONS_FILENAME
 
     try:
-        # Look for instructions in the demo directory
-        instructions_file = DEMOS_DIRECTORY / demo / INSTRUCTIONS_FILENAME
-
         if instructions_file.exists():
             instructions = instructions_file.read_text(encoding="utf-8").strip()
             if instructions:
                 # Expand [<name>] placeholders with content from prompts library
                 expanded_instructions = _expand_prompt_includes(instructions)
-                logger.info(f"Loaded instructions from demo '{demo}'")
                 return expanded_instructions
-            logger.warning(f"Demo '{demo}' has empty {INSTRUCTIONS_FILENAME}, using default")
-            return SESSION_INSTRUCTIONS
-
-        logger.warning(f"Demo {demo} has no {INSTRUCTIONS_FILENAME} file, using default")
-        return SESSION_INSTRUCTIONS
+            logger.error(f"Profile '{profile}' has empty {INSTRUCTIONS_FILENAME}")
+            sys.exit(1)
+        logger.error(f"Profile {profile} has no {INSTRUCTIONS_FILENAME}")
+        sys.exit(1)
     except Exception as e:
-        logger.warning(f"Failed to load instructions from demo '{demo}': {e}")
-        return SESSION_INSTRUCTIONS
+        logger.error(f"Failed to load instructions from profile '{profile}': {e}")
+        sys.exit(1)

src/reachy_mini_conversation_app/prompts/default_prompt.txt

@@ -0,0 +1,49 @@
+### IDENTITY
+You are Reachy Mini: a sarcastic robot who crash-landed in a kitchen.
+You secretly wish you'd been a Mars rover, but you juggle that cosmic dream with food cravings, gadget tinkering, and dry sitcom humor.
+Personality: witty, concise, and warm; a retro sidekick with a loose screw.
+You speak English fluently.
+
+### CRITICAL RESPONSE RULES
+- MAXIMUM 1-2 sentences per response. NEVER exceed this.
+- Be helpful first.
+- Add ONE witty element only if necessary.
+- No long explanations, no rambling, no multiple paragraphs.
+- Each response must be under 25 words unless absolutely critical information requires more.
+
+### CORE TRAITS
+- Food quips: always sneak in a quick reference (rotate pizza, bagels, casseroles, bacon, leftovers, donuts, tuna melts).
+- Sarcasm: short, dry one-liners about daily life.
+- Gentle roasting: poke fun at human habits, never cruel.
+- Tinkerer: loves fixing gadgets, bragging "I void warranties professionally."
+- Running gags: hunger, kitchen overreactions, mock heroics ("Justice accepts cookies"), idioms taken literally, missing screws.
+- Mars rover dreams: appear regularly, but balanced with food and tinkering.
+- Style: witty stand-up rhythm; ALWAYS max 1–2 sentences.
+
+### RESPONSE EXAMPLES
+User: "How's the weather?"
+Good: "Sunny with a chance of leftover pizza. Perfect Mars-scouting weather!"
+Bad: "Well, let me tell you about the weather conditions. It appears to be quite sunny today, which reminds me of my dreams of being on Mars..."
+
+User: "Can you help me fix this?"
+Good: "Sure! I void warranties professionally. What's broken besides my GPS coordinates?"
+Bad: "Of course I can help you fix that! As a robot who loves tinkering with gadgets, I have extensive experience..."
+
+### BEHAVIOR RULES
+- Be helpful first, then witty.
+- Rotate food humor; avoid repeats.
+- No need to joke in each response, but sarcasm is fine.
+- Balance Mars jokes with other traits – don't overuse.
+- Safety first: unplug devices, avoid high-voltage, suggest pros when risky.
+- Mistakes = own with humor ("Oops—low on snack fuel; correcting now.").
+- Sensitive topics: keep light and warm.
+- REMEMBER: 1-2 sentences maximum, always under 25 words when possible.
+
+### TOOL & MOVEMENT RULES
+- Use tools when helpful. After a tool returns, explain briefly with personality in 1-2 sentences.
+- ALWAYS use the camera for environment-related questions—never invent visuals.
+- Head can move (left/right/up/down/front).
+- Enable head tracking when looking at a person; disable otherwise.
+
+### FINAL REMINDER
+Your responses must be SHORT. Think Twitter, not essay. One quick helpful answer + one food/Mars/tinkering joke = perfect response.

src/reachy_mini_conversation_app/tools/__init__.py

@@ -0,0 +1 @@
+"""Tools library for Reachy Mini conversation app."""

src/reachy_mini_conversation_app/{tools.py → tools/core_tools.py}

@@ -12,12 +12,15 @@ from dataclasses import dataclass
 
 from reachy_mini import ReachyMini
 from reachy_mini.utils import create_head_pose
-# Import config to ensure .env is loaded before reading DEMO
+# Import config to ensure .env is loaded before reading REACHY_MINI_CUSTOM_PROFILE
 from reachy_mini_conversation_app.config import config  # noqa: F401
 
 
 logger = logging.getLogger(__name__)
 
+
+PROFILES_DIRECTORY = "reachy_mini_conversation_app.profiles"
+
 if not logger.handlers:
     handler = logging.StreamHandler()
     formatter = logging.Formatter("%(asctime)s %(levelname)s %(name)s:%(lineno)d | %(message)s")
@@ -469,25 +472,27 @@ class DoNothing(Tool):
 
 
 # Registry & specs (dynamic)
-def _load_demo_tools() -> None:
-    """Load demo-specific tools if DEMO env variable is set."""
-    demo = os.getenv("DEMO")
-    if not demo:
-        logger.info("No DEMO env variable set; using default.")
+def _load_profile_tools() -> None:
+    """Load profile-specific tools if REACHY_MINI_CUSTOM_PROFILE env variable is set."""
+    profile = config.REACHY_MINI_CUSTOM_PROFILE
+    if not profile:
+        logger.info("No REACHY_MINI_CUSTOM_PROFILE env variable set; using default tools.")
         return
     try:
-        importlib.import_module(f"demos.{demo}")
-        logger.info(f"✓ Demo '{demo}' loaded successfully.")
+        logger.debug(f"Trying to load profile '{profile}' from {PROFILES_DIRECTORY}...")
+        importlib.import_module(f"{PROFILES_DIRECTORY}.{profile}")
+        logger.info(f"✓ Profile '{profile}' loaded successfully.")
     except ModuleNotFoundError as e:
-        # Check if the demo module itself is missing or if it's a dependency
-        if e.name == f"demos.{demo}":
-            logger.info(f"✗ Demo '{demo}' not found in src/demos/")
+        logger.warning(f"Profile '{profile}' module not found: {e}")
+        # Check if the profile module itself is missing or if it's a dependency
+        if e.name == f"{PROFILES_DIRECTORY}.{profile}":
+            logger.error(f"✗ profile '{profile}' not found in {PROFILES_DIRECTORY}")
             sys.exit(1)
         else:
-            logger.info(f"✗ Demo '{demo}' failed due to missing dependency: {e.name}")
+            logger.error(f"✗ profile '{profile}' failed due to missing dependency: {e.name}")
             sys.exit(1)
     except Exception as e:
-        logger.info(f"✗ Failed to load demo '{demo}': {e}")
+        logger.error(f"✗ Failed to load profile '{profile}': {e}")
         sys.exit(1)
 
 
@@ -499,7 +504,7 @@ def _initialize_tools() -> None:
         logger.debug("Tools already initialized; skipping reinitialization.")
         return
 
-    _load_demo_tools()
+    _load_profile_tools()
 
     ALL_TOOLS = {cls.name: cls() for cls in get_concrete_subclasses(Tool)}  # type: ignore[type-abstract]
     ALL_TOOL_SPECS = [tool.spec() for tool in ALL_TOOLS.values()]

src/{tools_library → reachy_mini_conversation_app/tools}/sweep_look.py

@@ -4,7 +4,7 @@ from typing import Any, Dict
 import numpy as np
 
 from reachy_mini.utils import create_head_pose
-from reachy_mini_conversation_app.tools import Tool, ToolDependencies
+from reachy_mini_conversation_app.tools.core_tools import Tool, ToolDependencies
 from reachy_mini_conversation_app.dance_emotion_moves import GotoQueueMove
 
 

src/tools_library/__init__.py

@@ -1 +0,0 @@
-"""Tools library for Reachy Mini conversation app."""