Rename: reachy_mini_conversation_app → reachy_mini_language_tutor

Updated package name to better reflect the language learning focus:
- Renamed src/ package directory
- Updated all Python imports
- Updated CLI from reachy-mini-conversation-app to reachy-mini-language-tutor
- Updated pyproject.toml, README.md, CLAUDE.md, .gitignore
- Regenerated uv.lock

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

.gitignore

@@ -58,4 +58,4 @@ cache/
 .nfs*
 
 # User-created personalities (managed by UI)
-src/reachy_mini_conversation_app/profiles/user_personalities/
+src/reachy_mini_language_tutor/profiles/user_personalities/

CLAUDE.md

@@ -48,13 +48,13 @@ pip install -e .[all_vision,dev]
 
 ### Running the App
 ```bash
-reachy-mini-conversation-app                           # Console mode (default)
-reachy-mini-conversation-app --gradio                  # Web UI at http://127.0.0.1:7860/
-reachy-mini-conversation-app --head-tracker mediapipe # With face tracking
-reachy-mini-conversation-app --local-vision            # Local SmolVLM2 vision
-reachy-mini-conversation-app --wireless-version        # For wireless robot
-reachy-mini-conversation-app --no-camera               # Audio-only mode
-reachy-mini-conversation-app --profile <name>          # Load custom profile
+reachy-mini-language-tutor                           # Console mode (default)
+reachy-mini-language-tutor --gradio                  # Web UI at http://127.0.0.1:7860/
+reachy-mini-language-tutor --head-tracker mediapipe # With face tracking
+reachy-mini-language-tutor --local-vision            # Local SmolVLM2 vision
+reachy-mini-language-tutor --wireless-version        # For wireless robot
+reachy-mini-language-tutor --no-camera               # Audio-only mode
+reachy-mini-language-tutor --profile <name>          # Load custom profile
 ```
 
 ### Development Workflow
@@ -136,7 +136,7 @@ Six language tutor profiles available in `profiles/`:
 - **`italian_tutor`**: Chiara, an Italian tutor from Florence with cultural insights
 - **`portuguese_tutor`**: Rafael, a Brazilian Portuguese tutor from São Paulo
 
-Each profile in `src/reachy_mini_conversation_app/profiles/<name>/` contains:
+Each profile in `src/reachy_mini_language_tutor/profiles/<name>/` contains:
 - **`instructions.txt`**: System prompt with teaching methodology (supports `[placeholder]` syntax)
 - **`tools.txt`**: Enabled tools list (comment with `#`, one per line)
 - **`proactive.txt`**: Set to `true` for proactive greeting mode
@@ -230,7 +230,7 @@ LOCAL_VISION_MODEL=HuggingFaceTB/SmolVLM2-2.2B-Instruct  # Local vision model pa
 - **Type checking**: Strict mypy enabled (`mypy src/`)
 - **Formatting**: Ruff with 119-char line length
 - **Docstrings**: Required for all public functions/classes (ruff `D` rules enabled)
-- **Import sorting**: `isort` via ruff (local-folder: `reachy_mini_conversation_app`)
+- **Import sorting**: `isort` via ruff (local-folder: `reachy_mini_language_tutor`)
 - **Quote style**: Double quotes
 - **Async patterns**: Use `asyncio` for OpenAI realtime API, threading for robot control
 
@@ -238,7 +238,7 @@ LOCAL_VISION_MODEL=HuggingFaceTB/SmolVLM2-2.2B-Instruct  # Local vision model pa
 
 ### Adding Custom Tools
 1. Create Python file in `profiles/<profile_name>/` (e.g., `my_tool.py`)
-2. Subclass `reachy_mini_conversation_app.tools.core_tools.Tool`
+2. Subclass `reachy_mini_language_tutor.tools.core_tools.Tool`
 3. Implement `name`, `description`, `parameters`, and `__call__()` method
 4. Add tool name to `profiles/<profile_name>/tools.txt`
 5. See `profiles/french_tutor/recall.py` and `profiles/french_tutor/remember.py` for examples

README.md

@@ -52,8 +52,8 @@ Practice conversational skills in French, Spanish, German, Italian, Portuguese,
 ### Installation
 
 ```bash
-git clone https://github.com/pollen-robotics/reachy_mini_conversation_app.git
-cd reachy_mini_conversation_app
+git clone https://github.com/pollen-robotics/reachy_mini_language_tutor.git
+cd reachy_mini_language_tutor
 
 # Using uv (recommended)
 uv venv --python 3.12.1
@@ -80,13 +80,13 @@ SUPERMEMORY_API_KEY=...                  # Optional, for persistent memory
 
 ```bash
 # Practice French
-reachy-mini-conversation-app --profile french_tutor
+reachy-mini-language-tutor --profile french_tutor
 
 # Practice Spanish
-reachy-mini-conversation-app --profile spanish_tutor
+reachy-mini-language-tutor --profile spanish_tutor
 
 # Practice any language (robot will ask what you want to learn)
-reachy-mini-conversation-app
+reachy-mini-language-tutor
 ```
 
 Add `--gradio` for a web interface with live transcripts at http://127.0.0.1:7860/

pyproject.toml

@@ -3,7 +3,7 @@ requires = ["setuptools"]
 build-backend = "setuptools.build_meta"
 
 [project]
-name = "reachy_mini_conversation_app"
+name = "reachy_mini_language_tutor"
 version = "0.1.0"
 authors = [{ name = "Pollen Robotics", email = "contact@pollen-robotics.com" }]
 description = "Language learning companion for Reachy Mini robot with real-time conversation and persistent memory"
@@ -59,10 +59,10 @@ dev = [
 ]
 
 [project.scripts]
-reachy-mini-conversation-app = "reachy_mini_conversation_app.main:main"
+reachy-mini-language-tutor = "reachy_mini_language_tutor.main:main"
 
 [project.entry-points."reachy_mini_apps"]
-reachy_mini_conversation_app = "reachy_mini_conversation_app.main:ReachyMiniConversationApp"
+reachy_mini_language_tutor = "reachy_mini_language_tutor.main:ReachyMiniConversationApp"
 
 [tool.setuptools]
 package-dir = { "" = "src" }
@@ -72,7 +72,7 @@ include-package-data = true
 where = ["src"]
 
 [tool.setuptools.package-data]
-reachy_mini_conversation_app = [
+reachy_mini_language_tutor = [
   "images/*",
   "static/*",
   ".env.example",
@@ -106,7 +106,7 @@ ignore = [
 length-sort = true
 lines-after-imports = 2
 no-lines-before = ["standard-library", "local-folder"]
-known-local-folder = ["reachy_mini_conversation_app"]
+known-local-folder = ["reachy_mini_language_tutor"]
 known-first-party = ["reachy_mini", "reachy_mini_dances_library", "reachy_mini_toolbox"]
 split-on-trailing-comma = true
 

src/reachy_mini_conversation_app/profiles/spanish_tutor/recall.py

@@ -1,50 +0,0 @@
-"""Recall tool for searching learner memories."""
-
-from __future__ import annotations
-from typing import Any
-
-from reachy_mini_conversation_app.tools.core_tools import Tool, ToolDependencies
-
-
-class RecallTool(Tool):
-    """Search persistent memory for information about the learner."""
-
-    name = "recall"
-    description = (
-        "Search your memory for information about this learner from previous sessions. "
-        "Use this to check their progress, preferences, or past struggles before giving advice."
-    )
-    parameters_schema: dict[str, Any] = {
-        "type": "object",
-        "properties": {
-            "query": {
-                "type": "string",
-                "description": (
-                    "What to search for, e.g., 'vocabulary struggles', 'preferred topics', "
-                    "'last session progress', 'grammar they find difficult'"
-                ),
-            },
-        },
-        "required": ["query"],
-    }
-
-    async def __call__(self, deps: ToolDependencies, **kwargs: Any) -> dict[str, Any]:
-        """Search memories for the given query.
-
-        Args:
-            deps: Tool dependencies including memory_manager.
-            **kwargs: Tool arguments including 'query'.
-
-        Returns:
-            Dictionary with search results or error.
-
-        """
-        if not deps.memory_manager:
-            return {"error": "Memory not available", "memories": []}
-
-        query = kwargs.get("query", "")
-        if not query:
-            return {"error": "No query provided", "memories": []}
-
-        results = await deps.memory_manager.search(query)
-        return {"memories": results, "count": len(results)}

src/{reachy_mini_conversation_app → reachy_mini_language_tutor}/audio/head_wobbler.py

@@ -11,7 +11,7 @@ from collections.abc import Callable
 import numpy as np
 from numpy.typing import NDArray
 
-from reachy_mini_conversation_app.audio.speech_tapper import HOP_MS, SwayRollRT
+from reachy_mini_language_tutor.audio.speech_tapper import HOP_MS, SwayRollRT
 
 
 SAMPLE_RATE = 24000

src/{reachy_mini_conversation_app → reachy_mini_language_tutor}/console.py

@@ -22,9 +22,9 @@ from scipy.signal import resample
 
 from reachy_mini import ReachyMini
 from reachy_mini.media.media_manager import MediaBackend
-from reachy_mini_conversation_app.config import config
-from reachy_mini_conversation_app.openai_realtime import OpenaiRealtimeHandler
-from reachy_mini_conversation_app.headless_personality_ui import mount_personality_routes
+from reachy_mini_language_tutor.config import config
+from reachy_mini_language_tutor.openai_realtime import OpenaiRealtimeHandler
+from reachy_mini_language_tutor.headless_personality_ui import mount_personality_routes
 
 
 try:
@@ -115,7 +115,7 @@ class LocalStream:
           * If ``.env`` exists, replaces/append OPENAI_API_KEY line.
           * Else, copies template from ``<instance_path>/.env.example`` when present,
             otherwise falls back to the packaged template
-            ``reachy_mini_conversation_app/.env.example``.
+            ``reachy_mini_language_tutor/.env.example``.
           * Ensures the resulting file contains the full template plus the key.
         - Loads the written ``.env`` into the current process environment.
         """
@@ -164,7 +164,7 @@ class LocalStream:
         """Persist the startup personality to the instance .env and config."""
         selection = (profile or "").strip() or None
         try:
-            from reachy_mini_conversation_app.config import set_custom_profile
+            from reachy_mini_language_tutor.config import set_custom_profile
 
             set_custom_profile(selection)
         except Exception:
@@ -260,7 +260,7 @@ class LocalStream:
         @self._settings_app.get("/ready")
         def _ready() -> JSONResponse:
             try:
-                mod = sys.modules.get("reachy_mini_conversation_app.tools.core_tools")
+                mod = sys.modules.get("reachy_mini_language_tutor.tools.core_tools")
                 ready = bool(getattr(mod, "_TOOLS_INITIALIZED", False)) if mod else False
             except Exception:
                 ready = False
@@ -316,7 +316,7 @@ class LocalStream:
             try:
                 from dotenv import load_dotenv
 
-                from reachy_mini_conversation_app.config import set_custom_profile
+                from reachy_mini_language_tutor.config import set_custom_profile
 
                 env_path = Path(self._instance_path) / ".env"
                 if env_path.exists():

src/{reachy_mini_conversation_app → reachy_mini_language_tutor}/gradio_tutor_selector.py

@@ -5,16 +5,14 @@ tutor cards instead of the developer-oriented personality management interface.
 """
 
 from __future__ import annotations
-
+import os
 import json
 import logging
-import os
-from pathlib import Path
 from typing import Any
+from pathlib import Path
 
 import gradio as gr
 
-from .config import config
 
 logger = logging.getLogger(__name__)
 

src/{reachy_mini_conversation_app → reachy_mini_language_tutor}/main.py

@@ -1,6 +1,5 @@
 """Entrypoint for Reachy Language Partner."""
 
-import os
 import sys
 import time
 import asyncio
@@ -11,15 +10,14 @@ from typing import Any, Dict, List, Optional
 import gradio as gr
 from fastapi import FastAPI
 from fastrtc import Stream
-from gradio.utils import get_space
 
 from reachy_mini import ReachyMini, ReachyMiniApp
-from reachy_mini_conversation_app.utils import (
+from reachy_mini_language_tutor.utils import (
     parse_args,
     setup_logger,
     handle_vision_stuff,
 )
-from reachy_mini_conversation_app.config import set_custom_profile
+from reachy_mini_language_tutor.config import set_custom_profile
 
 
 def update_chatbot(chatbot: List[Dict[str, Any]], response: Dict[str, Any]) -> List[Dict[str, Any]]:
@@ -48,12 +46,12 @@ def run(
 ) -> None:
     """Run Reachy Language Partner."""
     # Putting these dependencies here makes the dashboard faster to load when the conversation app is installed
-    from reachy_mini_conversation_app.moves import MovementManager
-    from reachy_mini_conversation_app.config import config
-    from reachy_mini_conversation_app.console import LocalStream
-    from reachy_mini_conversation_app.openai_realtime import OpenaiRealtimeHandler
-    from reachy_mini_conversation_app.tools.core_tools import ToolDependencies
-    from reachy_mini_conversation_app.audio.head_wobbler import HeadWobbler
+    from reachy_mini_language_tutor.moves import MovementManager
+    from reachy_mini_language_tutor.config import config
+    from reachy_mini_language_tutor.console import LocalStream
+    from reachy_mini_language_tutor.openai_realtime import OpenaiRealtimeHandler
+    from reachy_mini_language_tutor.tools.core_tools import ToolDependencies
+    from reachy_mini_language_tutor.audio.head_wobbler import HeadWobbler
 
     logger = setup_logger(args.debug)
     logger.info("Starting Reachy Language Partner")
@@ -100,7 +98,7 @@ def run(
     # Initialize memory manager if API key is available
     memory_manager = None
     if config.SUPERMEMORY_API_KEY:
-        from reachy_mini_conversation_app.memory import TutorMemory
+        from reachy_mini_language_tutor.memory import TutorMemory
 
         profile_name = config.REACHY_MINI_CUSTOM_PROFILE or "default"
         memory_manager = TutorMemory(config.SUPERMEMORY_API_KEY, profile_name=profile_name)
@@ -124,7 +122,7 @@ def run(
     stream_manager: gr.Blocks | LocalStream | None = None
 
     if args.gradio:
-        from reachy_mini_conversation_app.gradio_tutor_selector import TutorSelectorUI
+        from reachy_mini_language_tutor.gradio_tutor_selector import TutorSelectorUI
 
         tutor_ui = TutorSelectorUI()
         tutor_ui.create_components()

src/{reachy_mini_conversation_app → reachy_mini_language_tutor}/openai_realtime.py

@@ -16,9 +16,9 @@ from numpy.typing import NDArray
 from scipy.signal import resample
 from websockets.exceptions import ConnectionClosedError
 
-from reachy_mini_conversation_app.config import config
-from reachy_mini_conversation_app.prompts import get_session_voice, get_session_language, get_session_instructions
-from reachy_mini_conversation_app.tools.core_tools import (
+from reachy_mini_language_tutor.config import config
+from reachy_mini_language_tutor.prompts import get_session_voice, get_session_language, get_session_instructions
+from reachy_mini_language_tutor.tools.core_tools import (
     ToolDependencies,
     get_tool_specs,
     dispatch_tool_call,
@@ -94,8 +94,8 @@ class OpenaiRealtimeHandler(AsyncStreamHandler):
         """
         try:
             # Update the in-process config value and env
-            from reachy_mini_conversation_app.config import config as _config
-            from reachy_mini_conversation_app.config import set_custom_profile
+            from reachy_mini_language_tutor.config import config as _config
+            from reachy_mini_language_tutor.config import set_custom_profile
 
             set_custom_profile(profile)
             logger.info(
@@ -328,7 +328,7 @@ The following is what you remember about this learner from previous sessions:
 
                 # Send proactive greeting when session is created
                 if event.type == "session.created" and not self._proactive_greeting_sent:
-                    from reachy_mini_conversation_app.prompts import get_profile_proactive_mode
+                    from reachy_mini_language_tutor.prompts import get_profile_proactive_mode
 
                     if get_profile_proactive_mode():
                         logger.info("Session created - sending proactive greeting")

src/{reachy_mini_conversation_app → reachy_mini_language_tutor}/profiles/french_tutor/recall.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 from typing import Any
 
-from reachy_mini_conversation_app.tools.core_tools import Tool, ToolDependencies
+from reachy_mini_language_tutor.tools.core_tools import Tool, ToolDependencies
 
 
 class RecallTool(Tool):

src/{reachy_mini_conversation_app/profiles/italian_tutor → reachy_mini_language_tutor/profiles/french_tutor}/remember.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 from typing import Any
 
-from reachy_mini_conversation_app.tools.core_tools import Tool, ToolDependencies
+from reachy_mini_language_tutor.tools.core_tools import Tool, ToolDependencies
 
 
 class RememberTool(Tool):

src/{reachy_mini_conversation_app/profiles/italian_tutor → reachy_mini_language_tutor/profiles/german_tutor}/recall.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 from typing import Any
 
-from reachy_mini_conversation_app.tools.core_tools import Tool, ToolDependencies
+from reachy_mini_language_tutor.tools.core_tools import Tool, ToolDependencies
 
 
 class RecallTool(Tool):

src/{reachy_mini_conversation_app/profiles/french_tutor → reachy_mini_language_tutor/profiles/german_tutor}/remember.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 from typing import Any
 
-from reachy_mini_conversation_app.tools.core_tools import Tool, ToolDependencies
+from reachy_mini_language_tutor.tools.core_tools import Tool, ToolDependencies
 
 
 class RememberTool(Tool):

src/{reachy_mini_conversation_app/profiles/german_tutor → reachy_mini_language_tutor/profiles/italian_tutor}/recall.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 from typing import Any
 
-from reachy_mini_conversation_app.tools.core_tools import Tool, ToolDependencies
+from reachy_mini_language_tutor.tools.core_tools import Tool, ToolDependencies
 
 
 class RecallTool(Tool):

src/{reachy_mini_conversation_app/profiles/portuguese_tutor → reachy_mini_language_tutor/profiles/italian_tutor}/remember.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 from typing import Any
 
-from reachy_mini_conversation_app.tools.core_tools import Tool, ToolDependencies
+from reachy_mini_language_tutor.tools.core_tools import Tool, ToolDependencies
 
 
 class RememberTool(Tool):