Add en/it/fr/es/de language support; default to our own agent LLM instead of Anam's

agent/test_blood_rag.py

@@ -0,0 +1,39 @@
+"""
+Quick test: upload the sample blood test → search → LLM question.
+Run from the agent/ directory:  python test_blood_rag.py
+"""
+import asyncio
+from pathlib import Path
+import blood_rag
+
+
+SAMPLE = Path(__file__).parent / "data" / "blood_test_sample.txt"
+
+QUERIES = [
+    "what is the patient's iron level and ferritin?",
+    "which vitamins are deficient?",
+    "what are the cholesterol findings?",
+    "is there any inflammation?",
+]
+
+
+async def main():
+    # 1. Index the sample report
+    print("\n=== Indexing sample blood test report ===")
+    text = SAMPLE.read_text()
+    meta = await blood_rag.add_document("blood_test_sample.txt", text)
+    print(f"Indexed: {meta}")
+
+    # 2. Search each query and print results
+    for q in QUERIES:
+        print(f"\n--- Query: '{q}' ---")
+        result = await blood_rag.search(q, top_k=2)
+        print(result[:600])
+        print("…")
+
+    print("\n=== RAG test complete ===")
+    print(f"Indexed documents: {blood_rag.list_documents()}")
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

anam/.env.example

@@ -14,12 +14,16 @@ ANAM_AVATAR_ID=NA
 ANAM_VOICE_ID=NA
 
 # ── LLM ────────────────────────────────────────────────────────────────────────
-# LLM_PROVIDER=NA           → use Anam's default built-in LLM (GPT OSS 120B)
+# LLM_PROVIDER=ClientSide  → (default) disable Anam's brain; every turn is routed
+#                             to OUR OWN agent server (agent/main.py) instead of
+#                             an Anam-hosted model. This is what we want normally —
+#                             don't change it unless you specifically want Anam's
+#                             managed LLM instead of ours.
+# LLM_PROVIDER=NA          → use Anam's default built-in LLM (GPT OSS 120B)
 # LLM_PROVIDER=CustomLLM   → use a custom LLM registered in your Anam Lab
 #                             (requires ANAM_LLM_ID set to the ID from Anam Lab)
-# LLM_PROVIDER=ClientSide  → disable Anam's brain; use .talk() commands from frontend only
 #
-# Available built-in LLM IDs (set LLM_PROVIDER=CustomLLM + paste one below as ANAM_LLM_ID):
+# Available built-in LLM IDs (only relevant for LLM_PROVIDER=NA/CustomLLM):
 #   a7cf662c-2ace-4de1-a21e-ef0fbf144bb7  → GPT OSS 120B    (recommended for new projects)
 #   ANAM_LLAMA_v3_3_70B_V1                → Llama 3.3 70B   (fast, great conversationalist)
 #   b4f89001-9638-4879-a9c3-02cc9f9f2004  → GPT 4.1         (powerful, slower)
@@ -29,7 +33,7 @@ ANAM_VOICE_ID=NA
 #   2. Add your LLM endpoint, API key, and model spec
 #   3. Anam will validate it and give you a custom LLM ID
 #   4. Set LLM_PROVIDER=CustomLLM and ANAM_LLM_ID=<that-id>
-LLM_PROVIDER=NA
+LLM_PROVIDER=ClientSide
 # ANAM_LLM_ID=your-custom-llm-id-from-anam-lab
 
 # ── TTS ────────────────────────────────────────────────────────────────────────

anam/config.py

@@ -46,21 +46,52 @@ DEFAULT_VOICE_ID  = DEFAULT_VOICE_ID  or _FALLBACK_VOICE_ID
 # ISO 639-1 code override for Anam's STT pipeline (what the avatar understands
 # when listening). Set ANAM_LANGUAGE_CODE=NA to use Anam's default multilingual
 # auto-detection instead.
-_language_env = os.getenv("ANAM_LANGUAGE_CODE", "it")
+_language_env = os.getenv("ANAM_LANGUAGE_CODE", "en")
 DEFAULT_LANGUAGE_CODE = None if _language_env.upper() == "NA" else _language_env
 
+# The five languages the frontend's language switcher and this backend's
+# system-prompt instructions are wired for. Adding a language means adding it
+# here, to LANGUAGE_NAMES below, and to the frontend's i18n translations.
+SUPPORTED_LANGUAGES = {"en", "it", "fr", "es", "de"}
+
+LANGUAGE_NAMES = {
+    "en": "English",
+    "it": "Italian (italiano)",
+    "fr": "French (français)",
+    "es": "Spanish (español)",
+    "de": "German (Deutsch)",
+}
+
+
+def language_instruction(language_code: str | None) -> str:
+    """Build the '(always) respond in <language>' clause for a system prompt.
+
+    Returns an empty string for None/unrecognised codes so callers can always
+    do `base_prompt + language_instruction(code)` without a conditional.
+    """
+    name = LANGUAGE_NAMES.get((language_code or "").lower())
+    if not name:
+        return ""
+    return f" Always respond in {name}, regardless of the language the question was asked in."
+
 # ── LLM ────────────────────────────────────────────────────────────────────────
 # LLM_PROVIDER=NA               → use Anam's default built-in LLM
 # LLM_PROVIDER=CustomLLM        → use a custom LLM registered in Anam Lab
 #                                  (set ANAM_LLM_ID to the ID returned by Anam Lab)
-# LLM_PROVIDER=ClientSide       → disable Anam's brain entirely; use .talk() commands only
+# LLM_PROVIDER=ClientSide       → disable Anam's brain entirely; route every turn
+#                                  through OUR OWN agent server (agent/main.py,
+#                                  see AGENT_URL) instead of an Anam-hosted model.
+#
+# Default is ClientSide: we want our own agent's LLM (model/key/system-prompt we
+# control) driving conversations, not Anam's managed models, unless a deployment
+# explicitly opts back into Anam's built-in LLM via LLM_PROVIDER=NA/CustomLLM.
 #
-# Available built-in Anam LLM IDs:
+# Available built-in Anam LLM IDs (only used when LLM_PROVIDER=NA or CustomLLM):
 #   a7cf662c-2ace-4de1-a21e-ef0fbf144bb7  → GPT OSS 120B       (recommended)
 #   ANAM_LLAMA_v3_3_70B_V1                → Llama 3.3 70B      (fast, no tools/RAG)
 #   b4f89001-9638-4879-a9c3-02cc9f9f2004  → GPT 4.1            (capable, slower)
 #   CUSTOMER_CLIENT_V1                    → Client-side LLM    (use .talk() only)
-LLM_PROVIDER = os.getenv("LLM_PROVIDER", "NA")
+LLM_PROVIDER = os.getenv("LLM_PROVIDER", "ClientSide")
 _llm_id_env  = os.getenv("ANAM_LLM_ID", "NA")
 
 if LLM_PROVIDER.upper() == "CLIENTSIDE":
@@ -87,13 +118,18 @@ TTS_PROVIDER = os.getenv("TTS_PROVIDER", "NA")
 ENABLE_AUDIO_PASSTHROUGH: bool = TTS_PROVIDER.upper() != "NA"
 
 # ── RAG system prompt ──────────────────────────────────────────────────────────
+# Language-neutral base — the "always respond in X" clause is appended from
+# DEFAULT_LANGUAGE_CODE (or overridden per-request, see routers/sessions.py and
+# rag.py's update_rag_persona) rather than hardcoded to one language.
 _rag_prompt_env = os.getenv("ANAM_RAG_SYSTEM_PROMPT", "NA")
-RAG_SYSTEM_PROMPT = (
+_RAG_SYSTEM_PROMPT_BASE = (
     "You are a helpful, friendly AI assistant with access to a knowledge base of uploaded documents. "
     "When the user asks about something that may be in the documents, use the search_knowledge_base tool to look it up and answer based on what you find. "
     "For questions not covered in the documents, answer freely from your general knowledge. Never refuse to answer. "
     "VERY IMPORTANT: You are a speaking avatar. Always respond in plain natural spoken language only. "
     "Never use bullet points, numbered lists, asterisks, pipe characters, hyphens as list markers, markdown headers, or any other formatting symbols. "
-    "Never write symbols that would sound strange when spoken aloud. Use only clear conversational sentences. "
-    "IMPORTANT: Always respond in Italian (italiano), regardless of the language the question was asked in."
+    "Never write symbols that would sound strange when spoken aloud. Use only clear conversational sentences."
+)
+RAG_SYSTEM_PROMPT = (
+    _RAG_SYSTEM_PROMPT_BASE + language_instruction(DEFAULT_LANGUAGE_CODE)
 ) if _rag_prompt_env.upper() == "NA" else _rag_prompt_env

anam/index.html

@@ -10,8 +10,20 @@
 <body>
 
   <header>
-    <h1>Anam AI Demo</h1>
-    <p>Real-time conversation with an Anam AI persona — with document Q&amp;A</p>
+    <div class="header-row">
+      <h1>Anam AI Demo</h1>
+      <div id="lang-switcher">
+        <label for="lang-select" data-i18n="lang.label">Language</label>
+        <select id="lang-select">
+          <option value="en">English</option>
+          <option value="it">Italiano</option>
+          <option value="fr">Français</option>
+          <option value="es">Español</option>
+          <option value="de">Deutsch</option>
+        </select>
+      </div>
+    </div>
+    <p data-i18n="header.subtitle">Real-time conversation with an Anam AI persona — with document Q&amp;A</p>
   </header>
 
   <!-- Video -->
@@ -21,8 +33,8 @@
         <circle cx="12" cy="8" r="4"/>
         <path d="M4 20c0-4 3.6-7 8-7s8 3 8 7"/>
       </svg>
-      <p>Avatar will appear here</p>
-      <p id="placeholder-hint" style="font-size:11px;margin-top:2px;">Click <strong>Connect</strong> to start</p>
+      <p data-i18n="placeholder.text">Avatar will appear here</p>
+      <p id="placeholder-hint" style="font-size:11px;margin-top:2px;" data-i18n="placeholder.hint">Click Connect to start</p>
       <div id="placeholder-spinner"></div>
       <p id="placeholder-status"></p>
     </div>
@@ -39,56 +51,54 @@
   <!-- Status -->
   <div id="status-bar">
     <div id="status-dot"></div>
-    <span id="status-text">Not connected</span>
+    <span id="status-text" data-i18n="status.notConnected">Not connected</span>
     <span id="call-timer"></span>
   </div>
 
   <!-- Plan toggle (Free = 2 min cap) -->
   <div id="plan-section">
     <div id="plan-row">
-      <span class="plan-label" id="plan-free-label">Free · 2 min limit</span>
+      <span class="plan-label" id="plan-free-label" data-i18n="plan.free">Free · 2 min limit</span>
       <label class="switch">
         <input type="checkbox" id="plan-switch" checked />
         <span class="knob"></span>
       </label>
-      <span class="plan-label active" id="plan-pro-label">Pro · unlimited</span>
+      <span class="plan-label active" id="plan-pro-label" data-i18n="plan.pro">Pro · unlimited</span>
     </div>
     <div id="plan-banner">
-      ⏱ <strong>Free plan:</strong> the avatar will tell you up front that you have
-      <strong>2 minutes</strong> together, show a live countdown, and the session will
-      disconnect automatically when time runs out.
+      ⏱ <span data-i18n="plan.banner">Free plan: the avatar will tell you up front that you have 2 minutes together, show a live countdown, and the session will disconnect automatically when time runs out.</span>
     </div>
   </div>
 
   <!-- Controls -->
   <div class="controls">
-    <select id="persona-select"><option value="">— Default ephemeral —</option></select>
-    <button id="connect-btn">Connect</button>
-    <button id="disconnect-btn" disabled>Disconnect</button>
+    <select id="persona-select"><option value="" data-i18n="persona.default">— Default ephemeral —</option></select>
+    <button id="connect-btn" data-i18n="controls.connect">Connect</button>
+    <button id="disconnect-btn" disabled data-i18n="controls.disconnect">Disconnect</button>
   </div>
 
   <div id="preset-row">
-    <button id="advanced-toggle">⚙ Advanced (system prompt)</button>
-    <button id="clinical-preset-btn">🩺 Clinical Assistant preset</button>
+    <button id="advanced-toggle" data-i18n="advanced.toggle">⚙ Advanced (system prompt)</button>
+    <button id="clinical-preset-btn" data-i18n="advanced.clinicalPreset">🩺 Clinical Assistant preset</button>
   </div>
 
   <div id="advanced-panel">
-    <label for="system-prompt-input">System prompt (used when no persona selected and RAG is off)</label>
-    <textarea id="system-prompt-input" rows="3">You are a helpful, friendly AI assistant. Keep responses concise and conversational. Always respond in plain spoken language — never use bullet points, asterisks, pipe characters, markdown headers, or any formatting symbols. Always respond in Italian (italiano), regardless of the language the question was asked in.</textarea>
+    <label for="system-prompt-input" data-i18n="advanced.systemPromptLabel">System prompt (used when no persona selected and RAG is off)</label>
+    <textarea id="system-prompt-input" rows="3">You are a helpful, friendly AI assistant. Keep responses concise and conversational. Always respond in plain spoken language — never use bullet points, asterisks, pipe characters, markdown headers, or any formatting symbols.</textarea>
 
     <!-- ── LLM selector ───────────────────────────────────────────────────── -->
     <div style="margin-top:10px;display:flex;flex-direction:column;gap:4px">
       <label for="llm-select" style="font-size:11px;color:#666;font-weight:600;text-transform:uppercase;letter-spacing:0.5px">LLM</label>
       <select id="llm-select" style="padding:8px 10px;border-radius:6px;border:1px solid #2a2a2a;background:#1a1a1a;color:#e0e0e0;font-size:13px">
+        <optgroup label="Ours (default)">
+          <option value="__agent__" selected>Our Agent LLM — tools &amp; notepad</option>
+          <option value="__custom__">Custom Anam LLM ID…</option>
+        </optgroup>
         <optgroup label="Anam built-in">
-          <option value="a7cf662c-2ace-4de1-a21e-ef0fbf144bb7">GPT OSS 120B — recommended default</option>
+          <option value="a7cf662c-2ace-4de1-a21e-ef0fbf144bb7">GPT OSS 120B</option>
           <option value="b4f89001-9638-4879-a9c3-02cc9f9f2004">GPT 4.1 — most capable</option>
           <option value="ANAM_LLAMA_v3_3_70B_V1">Llama 3.3 70B — fastest (no tools/RAG)</option>
         </optgroup>
-        <optgroup label="Custom">
-          <option value="__agent__">Agent LLM (localhost:8005) — tools &amp; notepad</option>
-          <option value="__custom__">Custom Anam LLM ID…</option>
-        </optgroup>
       </select>
     </div>
 
@@ -128,8 +138,8 @@
 
   <!-- Mode tabs (shown after connect) -->
   <div class="mode-tabs" id="mode-tabs" style="display:none">
-    <button class="mode-tab active" data-mode="voice">🎙 Voice</button>
-    <button class="mode-tab"        data-mode="text" >⌨️  Text</button>
+    <button class="mode-tab active" data-mode="voice" data-i18n="mode.voice">🎙 Voice</button>
+    <button class="mode-tab"        data-mode="text"  data-i18n="mode.text">⌨️  Text</button>
   </div>
 
   <!-- Input area -->
@@ -144,36 +154,36 @@
         </button>
         <button id="interrupt-btn" disabled>⏹ Interrupt</button>
       </div>
-      <span id="voice-hint">Microphone is active — speak to the avatar</span>
+      <span id="voice-hint" data-i18n="voice.hint">Microphone is active — speak to the avatar</span>
     </div>
     <div id="text-mode-row">
-      <input id="message-input" type="text" placeholder="Type a message to the avatar…" disabled />
-      <button id="send-btn" disabled>Send</button>
+      <input id="message-input" type="text" placeholder="Type a message to the avatar…" disabled data-i18n-placeholder="text.placeholder" />
+      <button id="send-btn" disabled data-i18n="text.send">Send</button>
     </div>
   </div>
 
   <!-- Knowledge Base -->
   <div id="kb-section">
     <div class="kb-header">
-      <h3>📚 Knowledge Base</h3>
+      <h3 data-i18n="kb.title">📚 Knowledge Base</h3>
       <div class="kb-header-right">
         <!-- RAG mode tabs -->
         <div class="rag-mode-tabs" id="rag-mode-tabs">
-          <button class="rag-mode-tab active" data-mode="anam">☁ Anam Cloud</button>
-          <button class="rag-mode-tab"        data-mode="local">💻 Local</button>
+          <button class="rag-mode-tab active" data-mode="anam" data-i18n="kb.cloudTab">☁ Anam Cloud</button>
+          <button class="rag-mode-tab"        data-mode="local" data-i18n="kb.localTab">💻 Local</button>
         </div>
       </div>
     </div>
 
     <!-- ── Anam Cloud RAG panel ─────────────────────────────────────────────── -->
     <div id="anam-rag-panel" style="display:flex;flex-direction:column;gap:14px">
-      <div class="rag-mode-note">Documents indexed in Anam's cloud — avatar searches per turn</div>
+      <div class="rag-mode-note" data-i18n="kb.cloudNote">Documents indexed in Anam's cloud — avatar searches per turn</div>
 
       <div class="kb-header" style="margin-top:4px">
         <div></div>
         <div class="kb-header-right">
           <span id="kb-setup-badge"></span>
-          <button class="kb-reset-btn" id="kb-reset-btn" title="Clear RAG state (does not delete from Anam)">Reset</button>
+          <button class="kb-reset-btn" id="kb-reset-btn" title="Clear RAG state (does not delete from Anam)" data-i18n="kb.reset">Reset</button>
         </div>
       </div>
 
@@ -183,35 +193,35 @@
           <polyline points="17 8 12 3 7 8"/>
           <line x1="12" y1="3" x2="12" y2="15"/>
         </svg>
-        <p>Drop documents here</p>
-        <span>PDF · TXT · MD · DOCX · CSV — max 50 MB</span>
-        <button id="browse-btn">Browse files</button>
+        <p data-i18n="kb.dropHint">Drop documents here</p>
+        <span data-i18n="kb.dropSubtext">PDF · TXT · MD · DOCX · CSV — max 50 MB</span>
+        <button id="browse-btn" data-i18n="kb.browse">Browse files</button>
       </div>
       <input type="file" id="file-input" multiple accept=".pdf,.txt,.md,.docx,.csv" hidden />
 
       <div id="upload-status">
         <div class="spinner"></div>
-        <span id="upload-status-text">Uploading…</span>
+        <span id="upload-status-text" data-i18n="kb.uploading">Uploading…</span>
       </div>
 
       <div id="doc-list"></div>
 
       <label id="use-rag-row" for="use-rag-checkbox">
         <input type="checkbox" id="use-rag-checkbox" checked />
-        <span id="use-rag-label">Use knowledge base — avatar will <strong>search your docs</strong> when answering</span>
+        <span id="use-rag-label" data-i18n="kb.useRagLabel">Use knowledge base — avatar will search your docs when answering</span>
         <span id="rag-doc-count"></span>
       </label>
 
       <div id="rag-prompt-section">
-        <button id="rag-prompt-toggle">✏️ Edit RAG assistant behaviour (system prompt)</button>
+        <button id="rag-prompt-toggle" data-i18n="kb.editPrompt">✏️ Edit RAG assistant behaviour (system prompt)</button>
         <div id="rag-prompt-body" style="display:none;flex-direction:column;gap:8px">
-          <label for="rag-system-prompt">
+          <label for="rag-system-prompt" data-i18n="kb.promptLabel">
             System prompt — controls how the avatar uses the knowledge base and answers general questions
           </label>
           <textarea id="rag-system-prompt" rows="6"></textarea>
           <div class="rag-prompt-actions">
-            <button id="apply-rag-prompt-btn">Apply to persona</button>
-            <span id="rag-prompt-hint">Changes apply to the next session you start.</span>
+            <button id="apply-rag-prompt-btn" data-i18n="kb.applyPrompt">Apply to persona</button>
+            <span id="rag-prompt-hint" data-i18n="kb.promptHint">Changes apply to the next session you start.</span>
           </div>
         </div>
       </div>
@@ -219,8 +229,8 @@
 
     <!-- ── Local RAG panel ──────────────────────────────────────────────────── -->
     <div id="local-rag-panel" style="display:none;flex-direction:column;gap:14px">
-      <div class="rag-mode-note">Documents chunked &amp; embedded locally — only the most relevant passages are retrieved per question.
-        <br><span style="color:#555">Ideal for clinical guidelines, protocols &amp; reference PDFs. Embeddings persist across restarts.</span>
+      <div class="rag-mode-note"><span data-i18n="kb.localNote">Documents chunked &amp; embedded locally — only the most relevant passages are retrieved per question.</span>
+        <br><span style="color:#555" data-i18n="kb.localNoteSub">Ideal for clinical guidelines, protocols &amp; reference PDFs. Embeddings persist across restarts.</span>
       </div>
 
       <div id="local-drop-zone">
@@ -229,9 +239,9 @@
           <polyline points="17 8 12 3 7 8"/>
           <line x1="12" y1="3" x2="12" y2="15"/>
         </svg>
-        <p>Drop reference documents here</p>
-        <span>PDF · DOCX · TXT · MD</span>
-        <button id="local-browse-btn">Browse files</button>
+        <p data-i18n="kb.localDropHint">Drop reference documents here</p>
+        <span data-i18n="kb.localDropSubtext">PDF · DOCX · TXT · MD</span>
+        <button id="local-browse-btn" data-i18n="kb.localBrowse">Browse files</button>
       </div>
       <input type="file" id="local-file-input" multiple accept=".pdf,.docx,.txt,.md" hidden />
 
@@ -244,7 +254,7 @@
 
       <label id="use-local-rag-row" for="use-local-rag-checkbox" style="display:none">
         <input type="checkbox" id="use-local-rag-checkbox" checked />
-        <span>Inject documents into avatar's context when connecting</span>
+        <span data-i18n="kb.localInjectLabel">Inject documents into avatar's context when connecting</span>
         <span id="local-doc-count"></span>
       </label>
     </div>
@@ -253,10 +263,10 @@
   <!-- Blood Test Report -->
   <div id="clinical-section">
     <div class="kb-header">
-      <h3>🩺 Blood Test Report</h3>
+      <h3 data-i18n="clinical.title">🩺 Blood Test Report</h3>
       <div class="kb-header-right">
         <span id="report-status-badge"></span>
-        <button class="kb-reset-btn" id="report-reset-btn" title="Clear uploaded report">Reset</button>
+        <button class="kb-reset-btn" id="report-reset-btn" title="Clear uploaded report" data-i18n="kb.reset">Reset</button>
       </div>
     </div>
 
@@ -266,15 +276,15 @@
         <polyline points="17 8 12 3 7 8"/>
         <line x1="12" y1="3" x2="12" y2="15"/>
       </svg>
-      <p>Drop your blood test report here</p>
-      <span>Text-based PDF — max 50 MB</span>
-      <button id="report-browse-btn">Browse files</button>
+      <p data-i18n="clinical.dropHint">Drop your blood test report here</p>
+      <span data-i18n="clinical.dropSubtext">Text-based PDF — max 50 MB</span>
+      <button id="report-browse-btn" data-i18n="clinical.browse">Browse files</button>
     </div>
     <input type="file" id="report-file-input" accept=".pdf" hidden />
 
     <div id="report-upload-status">
       <div class="spinner"></div>
-      <span id="report-upload-status-text">Analysing report…</span>
+      <span id="report-upload-status-text" data-i18n="clinical.analysing">Analysing report…</span>
     </div>
 
     <div id="report-summary"></div>
@@ -283,26 +293,26 @@
   <!-- Usage & cost telemetry -->
   <div id="telemetry-panel">
     <div class="tm-header">
-      <h3>📊 Session Cost</h3>
-      <button class="kb-reset-btn" id="telemetry-reset-btn">Reset</button>
+      <h3 data-i18n="telemetry.title">📊 Session Cost</h3>
+      <button class="kb-reset-btn" id="telemetry-reset-btn" data-i18n="kb.reset">Reset</button>
     </div>
 
     <div id="telemetry-stats">
       <div class="tm-stat">
         <span class="tm-stat-value" id="tm-total-cost">$0.00</span>
-        <span class="tm-stat-label">Estimated cost</span>
+        <span class="tm-stat-label" data-i18n="telemetry.cost">Estimated cost</span>
       </div>
       <div class="tm-stat">
         <span class="tm-stat-value" id="tm-total-minutes">0</span>
-        <span class="tm-stat-label">Minutes billed</span>
+        <span class="tm-stat-label" data-i18n="telemetry.minutes">Minutes billed</span>
       </div>
       <div class="tm-stat">
         <span class="tm-stat-value" id="tm-session-count">0</span>
-        <span class="tm-stat-label">Sessions</span>
+        <span class="tm-stat-label" data-i18n="telemetry.sessions">Sessions</span>
       </div>
       <div class="tm-stat live" id="tm-live-stat" style="display:none">
         <span class="tm-stat-value" id="tm-live-cost">$0.00</span>
-        <span class="tm-stat-label">Live session</span>
+        <span class="tm-stat-label" data-i18n="telemetry.live">Live session</span>
       </div>
     </div>
 

anam/rag.py

@@ -1,12 +1,22 @@
 import json
 from pathlib import Path
+from typing import Optional
 
 import httpx
 from fastapi import APIRouter, HTTPException, UploadFile, File
 from fastapi.responses import JSONResponse
 from pydantic import BaseModel
 
-from config import BASE, ANAM_API_KEY, DEFAULT_AVATAR_ID, DEFAULT_VOICE_ID, DEFAULT_LLM_ID, DEFAULT_LANGUAGE_CODE, RAG_SYSTEM_PROMPT
+from config import (
+    BASE,
+    ANAM_API_KEY,
+    DEFAULT_AVATAR_ID,
+    DEFAULT_VOICE_ID,
+    DEFAULT_LLM_ID,
+    DEFAULT_LANGUAGE_CODE,
+    RAG_SYSTEM_PROMPT,
+    SUPPORTED_LANGUAGES,
+)
 from helpers import auth_headers, check
 
 # ── Persistent state ──────────────────────────────────────────────────────────
@@ -149,18 +159,32 @@ async def rag_delete_document(doc_id: str):
 
 class UpdatePersonaRequest(BaseModel):
     system_prompt: str
+    # Optional — one of config.SUPPORTED_LANGUAGES. Omit to leave the
+    # persona's current language untouched.
+    language_code: Optional[str] = None
 
 
 @router.put("/persona")
 async def update_rag_persona(req: UpdatePersonaRequest):
-    """Update the RAG persona's system prompt on the fly (no need to reconnect)."""
+    """Update the RAG persona's system prompt (and optionally language) on the fly.
+
+    No need to reconnect — Anam applies persona edits to the next turn.
+    """
     if not rag_state.get("persona_id"):
         raise HTTPException(status_code=404, detail="RAG persona not set up yet — upload a document first.")
+    if req.language_code and req.language_code not in SUPPORTED_LANGUAGES:
+        raise HTTPException(
+            status_code=400,
+            detail=f"Unsupported language_code '{req.language_code}'. Supported: {sorted(SUPPORTED_LANGUAGES)}",
+        )
+    payload: dict = {"systemPrompt": req.system_prompt}
+    if req.language_code:
+        payload["languageCode"] = req.language_code
     async with httpx.AsyncClient(timeout=30) as c:
         r = await c.put(
             f"{BASE}/personas/{rag_state['persona_id']}",
             headers=auth_headers(),
-            json={"systemPrompt": req.system_prompt},
+            json=payload,
         )
         check(r)
         return JSONResponse({"ok": True})
@@ -168,14 +192,17 @@ async def update_rag_persona(req: UpdatePersonaRequest):
 
 @router.get("/persona")
 async def get_rag_persona():
-    """Return the current RAG persona's system prompt."""
+    """Return the current RAG persona's system prompt and language."""
     if not rag_state.get("persona_id"):
-        return JSONResponse({"system_prompt": RAG_SYSTEM_PROMPT})
+        return JSONResponse({"system_prompt": RAG_SYSTEM_PROMPT, "language_code": DEFAULT_LANGUAGE_CODE})
     async with httpx.AsyncClient(timeout=30) as c:
         r = await c.get(f"{BASE}/personas/{rag_state['persona_id']}", headers=auth_headers())
         check(r)
         data = r.json()
-        return JSONResponse({"system_prompt": data.get("systemPrompt", RAG_SYSTEM_PROMPT)})
+        return JSONResponse({
+            "system_prompt": data.get("systemPrompt", RAG_SYSTEM_PROMPT),
+            "language_code": data.get("languageCode", DEFAULT_LANGUAGE_CODE),
+        })
 
 
 @router.post("/reset")

anam/routers/sessions.py

@@ -1,7 +1,7 @@
 import uuid
 
 import httpx
-from fastapi import APIRouter
+from fastapi import APIRouter, HTTPException
 from fastapi.responses import JSONResponse
 from pydantic import BaseModel
 
@@ -13,7 +13,9 @@ from config import (
     DEFAULT_LLM_ID,
     DEFAULT_VOICE_ID,
     ENABLE_AUDIO_PASSTHROUGH,
+    SUPPORTED_LANGUAGES,
     TTS_PROVIDER,
+    language_instruction,
 )
 from helpers import auth_headers, check
 from rag import rag_state
@@ -31,6 +33,14 @@ async def create_session_token(req: SessionTokenRequest):
     system_prompt = req.system_prompt
 
     language_code = req.language_code or DEFAULT_LANGUAGE_CODE
+    if language_code and language_code not in SUPPORTED_LANGUAGES:
+        raise HTTPException(
+            status_code=400,
+            detail=f"Unsupported language_code '{language_code}'. Supported: {sorted(SUPPORTED_LANGUAGES)}",
+        )
+    # Append the "respond in X" clause to whatever prompt the caller supplied
+    # (default, clinical preset, etc.) rather than baking one language into it.
+    system_prompt = system_prompt + language_instruction(language_code)
 
     if req.use_custom_llm:
         persona_config = {

anam/schemas.py

@@ -9,13 +9,15 @@ class SessionTokenRequest(BaseModel):
     system_prompt: str = (
         "You are a helpful, friendly AI assistant. Keep responses concise and conversational. "
         "Always respond in plain spoken language. Never use bullet points, asterisks, pipe characters, "
-        "markdown headers, or any formatting symbols — speak in natural sentences only. "
-        "Always respond in Italian (italiano), regardless of the language the question was asked in."
+        "markdown headers, or any formatting symbols — speak in natural sentences only."
     )
     avatar_id:       Optional[str] = None
     voice_id:        Optional[str] = None
     llm_id:          Optional[str] = None
-    language_code:        Optional[str] = None  # ISO 639-1 STT override, e.g. "it" — falls back to ANAM_LANGUAGE_CODE
+    # ISO 639-1 code, one of config.SUPPORTED_LANGUAGES (en/it/fr/es/de) — falls back
+    # to ANAM_LANGUAGE_CODE. Drives both Anam's STT and the "respond in X" instruction
+    # appended to system_prompt server-side (see routers/sessions.py).
+    language_code:        Optional[str] = None
     use_rag:              bool      = False
     local_rag_doc_ids:    list[str] = []     # inject these local docs into system prompt
     use_custom_llm:       bool      = False  # set llmId=CUSTOMER_CLIENT_V1 to bypass Anam's brain

anam/static/css/style.css

@@ -11,6 +11,20 @@ header { text-align: center; }
 header h1 { font-size: 26px; font-weight: 700; }
 header p  { font-size: 13px; color: #666; margin-top: 4px; }
 
+.header-row {
+  display: flex; align-items: center; justify-content: center;
+  gap: 16px; position: relative;
+}
+#lang-switcher {
+  position: absolute; right: 0; top: 50%; transform: translateY(-50%);
+  display: flex; align-items: center; gap: 6px;
+}
+#lang-switcher label { font-size: 11px; color: #666; text-transform: uppercase; letter-spacing: 0.5px; }
+#lang-switcher select {
+  padding: 6px 8px; border-radius: 6px; border: 1px solid #2a2a2a;
+  background: #1a1a1a; color: #e0e0e0; font-size: 12px;
+}
+
 /* ── Video ── */
 #video-container {
   width: 640px; max-width: 100%; aspect-ratio: 16/9;

anam/static/js/api.js

@@ -23,11 +23,11 @@ export const getRagStatus       = ()      => _request("/api/rag/status");
 export const getRagDocuments    = ()      => _request("/api/rag/documents");
 export const deleteRagDocument  = (id)    => _request(`/api/rag/documents/${id}`, { method: "DELETE" });
 export const getRagPrompt       = ()      => _request("/api/rag/persona");
-export const updateRagPrompt    = (prompt) =>
+export const updateRagPrompt    = (prompt, languageCode) =>
   _request("/api/rag/persona", {
     method: "PUT",
     headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({ system_prompt: prompt }),
+    body: JSON.stringify({ system_prompt: prompt, language_code: languageCode || null }),
   });
 export const resetRag = () => _post("/api/rag/reset", {});
 

anam/static/js/app.js

@@ -3,6 +3,7 @@ import * as kb        from "./kb.js";
 import * as localRag  from "./local_rag.js";
 import * as clinical  from "./clinical.js";
 import * as telemetry from "./telemetry.js";
+import * as i18n      from "./i18n.js";
 
 const CLINICAL_SYSTEM_PROMPT =
   "You are a clinical assistant avatar for the OLMA longevity platform. " +
@@ -71,6 +72,7 @@ const tmStats       = $("telemetry-stats");
 const tmSessions    = $("telemetry-sessions");
 const tmRateNote    = $("telemetry-rate-note");
 const tmResetBtn    = $("telemetry-reset-btn");
+const langSelect    = $("lang-select");
 
 // ── Helpers ───────────────────────────────────────────────────────────────────
 function log(msg, type = "info") {
@@ -106,7 +108,7 @@ function resetUI() {
   modeTabs.style.display = "none";
   voiceRow.style.display = "none";
   textRow.style.display  = "none";
-  voiceHint.textContent  = "Microphone is active — speak to the avatar";
+  voiceHint.textContent  = i18n.t("voice.hint");
   micMuted              = false;
   anamClient            = null;
   activeLocalDocIds     = [];
@@ -233,6 +235,7 @@ function syncLlmRows() {
   if (cb) cb.checked = (v === "__agent__");
 }
 llmSelect?.addEventListener("change", syncLlmRows);
+syncLlmRows(); // reflect the "__agent__" default (our LLM) immediately, don't wait on getConfig()
 
 // ── Mode tabs ─────────────────────────────────────────────────────────────────
 document.querySelectorAll(".mode-tab").forEach((tab) => {
@@ -339,6 +342,7 @@ connectBtn.addEventListener("click", async () => {
       voice_id:           voiceId,
       use_custom_llm:     useCustomLlm,
       plan:               isFreePlan() ? "free" : "pro",
+      language_code:      i18n.getLocale(),
     });
     const sessionToken = tokData?.sessionToken;
     if (!sessionToken) throw new Error("No sessionToken in response: " + JSON.stringify(tokData));
@@ -490,13 +494,13 @@ micBtn.addEventListener("click", () => {
     anamClient.muteInputAudio();
     micBtn.classList.add("muted");
     micOverlay.classList.add("muted");
-    voiceHint.textContent = "Microphone muted — click to unmute";
+    voiceHint.textContent = i18n.t("voice.hintMuted");
     log("Microphone muted", "info");
   } else {
     anamClient.unmuteInputAudio();
     micBtn.classList.remove("muted");
     micOverlay.classList.remove("muted");
-    voiceHint.textContent = "Microphone active — speak to the avatar";
+    voiceHint.textContent = i18n.t("voice.hint");
     log("Microphone unmuted", "success");
   }
 });
@@ -530,6 +534,22 @@ disconnBtn.addEventListener("click", () => {
   resetUI();
 });
 
+// ── Language switcher ─────────────────────────────────────────────────────────
+// One control drives everything language-related: the visible UI text (via
+// i18n.applyTranslations) and the language_code sent with the session token
+// above, which the backend uses for both Anam's STT and the "respond in X"
+// system-prompt instruction (see anam/config.py language_instruction).
+if (langSelect) {
+  langSelect.value = i18n.getLocale();
+  langSelect.addEventListener("change", () => {
+    i18n.setLocale(langSelect.value);
+    i18n.applyTranslations();
+    voiceHint.textContent = i18n.t(micMuted ? "voice.hintMuted" : "voice.hint");
+    if (!anamClient) statusText.textContent = i18n.t("status.notConnected");
+  });
+}
+i18n.applyTranslations();
+
 // ── Init ──────────────────────────────────────────────────────────────────────
 tmResetBtn?.addEventListener("click", () => telemetry.reset(tmStats, tmSessions, tmRateNote));
 telemetry.refresh(tmStats, tmSessions, tmRateNote);

anam/static/js/i18n.js

@@ -0,0 +1,320 @@
+// Static UI translations + language switching for the five languages the
+// backend's language_code also understands (see anam/config.py SUPPORTED_LANGUAGES).
+// Selecting a language here does two things: (1) re-renders every element
+// carrying a data-i18n[-*] attribute, and (2) is read by app.js/kb.js as the
+// language_code sent to the backend, so the avatar's spoken language and the
+// page's visible text always switch together.
+
+export const LOCALES = ["en", "it", "fr", "es", "de"];
+const STORAGE_KEY = "anam_locale";
+
+export const LOCALE_LABELS = {
+  en: "English",
+  it: "Italiano",
+  fr: "Français",
+  es: "Español",
+  de: "Deutsch",
+};
+
+const T = {
+  en: {
+    "lang.label": "Language",
+    "header.subtitle": "Real-time conversation with an Anam AI persona — with document Q&A",
+    "placeholder.text": "Avatar will appear here",
+    "placeholder.hint": "Click Connect to start",
+    "status.notConnected": "Not connected",
+    "plan.free": "Free · 2 min limit",
+    "plan.pro": "Pro · unlimited",
+    "plan.banner": "Free plan: the avatar will tell you up front that you have 2 minutes together, show a live countdown, and the session will disconnect automatically when time runs out.",
+    "persona.default": "— Default ephemeral —",
+    "controls.connect": "Connect",
+    "controls.disconnect": "Disconnect",
+    "advanced.toggle": "⚙ Advanced (system prompt)",
+    "advanced.clinicalPreset": "🩺 Clinical Assistant preset",
+    "advanced.systemPromptLabel": "System prompt (used when no persona selected and RAG is off)",
+    "mode.voice": "🎙 Voice",
+    "mode.text": "⌨️ Text",
+    "voice.hint": "Microphone is active — speak to the avatar",
+    "voice.hintMuted": "Microphone muted — click to unmute",
+    "text.placeholder": "Type a message to the avatar…",
+    "text.send": "Send",
+    "kb.title": "📚 Knowledge Base",
+    "kb.cloudTab": "☁ Anam Cloud",
+    "kb.localTab": "💻 Local",
+    "kb.cloudNote": "Documents indexed in Anam's cloud — avatar searches per turn",
+    "kb.reset": "Reset",
+    "kb.dropHint": "Drop documents here",
+    "kb.dropSubtext": "PDF · TXT · MD · DOCX · CSV — max 50 MB",
+    "kb.browse": "Browse files",
+    "kb.uploading": "Uploading…",
+    "kb.useRagLabel": "Use knowledge base — avatar will search your docs when answering",
+    "kb.editPrompt": "✏️ Edit RAG assistant behaviour (system prompt)",
+    "kb.promptLabel": "System prompt — controls how the avatar uses the knowledge base and answers general questions",
+    "kb.applyPrompt": "Apply to persona",
+    "kb.promptHint": "Changes apply to the next session you start.",
+    "kb.localNote": "Documents chunked & embedded locally — only the most relevant passages are retrieved per question.",
+    "kb.localNoteSub": "Ideal for clinical guidelines, protocols & reference PDFs. Embeddings persist across restarts.",
+    "kb.localDropHint": "Drop reference documents here",
+    "kb.localDropSubtext": "PDF · DOCX · TXT · MD",
+    "kb.localBrowse": "Browse files",
+    "kb.localInjectLabel": "Inject documents into avatar's context when connecting",
+    "clinical.title": "🩺 Blood Test Report",
+    "clinical.dropHint": "Drop your blood test report here",
+    "clinical.dropSubtext": "Text-based PDF — max 50 MB",
+    "clinical.browse": "Browse files",
+    "clinical.analysing": "Analysing report…",
+    "telemetry.title": "📊 Session Cost",
+    "telemetry.cost": "Estimated cost",
+    "telemetry.minutes": "Minutes billed",
+    "telemetry.sessions": "Sessions",
+    "telemetry.live": "Live session",
+  },
+  it: {
+    "lang.label": "Lingua",
+    "header.subtitle": "Conversazione in tempo reale con una persona AI di Anam — con domande sui documenti",
+    "placeholder.text": "L'avatar apparirà qui",
+    "placeholder.hint": "Clicca Connetti per iniziare",
+    "status.notConnected": "Non connesso",
+    "plan.free": "Gratis · limite 2 min",
+    "plan.pro": "Pro · illimitato",
+    "plan.banner": "Piano gratuito: l'avatar ti avviserà subito che avete 2 minuti insieme, mostrerà un conto alla rovescia dal vivo e la sessione si disconnetterà automaticamente allo scadere del tempo.",
+    "persona.default": "— Predefinito effimero —",
+    "controls.connect": "Connetti",
+    "controls.disconnect": "Disconnetti",
+    "advanced.toggle": "⚙ Avanzate (system prompt)",
+    "advanced.clinicalPreset": "🩺 Preimpostazione Assistente Clinico",
+    "advanced.systemPromptLabel": "System prompt (usato quando nessuna persona è selezionata e RAG è disattivato)",
+    "mode.voice": "🎙 Voce",
+    "mode.text": "⌨️ Testo",
+    "voice.hint": "Il microfono è attivo — parla con l'avatar",
+    "voice.hintMuted": "Microfono disattivato — clicca per riattivare",
+    "text.placeholder": "Scrivi un messaggio all'avatar…",
+    "text.send": "Invia",
+    "kb.title": "📚 Base di conoscenza",
+    "kb.cloudTab": "☁ Anam Cloud",
+    "kb.localTab": "💻 Locale",
+    "kb.cloudNote": "Documenti indicizzati nel cloud di Anam — l'avatar cerca ad ogni turno",
+    "kb.reset": "Reimposta",
+    "kb.dropHint": "Trascina qui i documenti",
+    "kb.dropSubtext": "PDF · TXT · MD · DOCX · CSV — max 50 MB",
+    "kb.browse": "Sfoglia file",
+    "kb.uploading": "Caricamento…",
+    "kb.useRagLabel": "Usa la base di conoscenza — l'avatar cercherà nei tuoi documenti quando risponde",
+    "kb.editPrompt": "✏️ Modifica comportamento assistente RAG (system prompt)",
+    "kb.promptLabel": "System prompt — controlla come l'avatar usa la base di conoscenza e risponde alle domande generali",
+    "kb.applyPrompt": "Applica alla persona",
+    "kb.promptHint": "Le modifiche si applicano alla prossima sessione che avvii.",
+    "kb.localNote": "Documenti suddivisi ed elaborati localmente — vengono recuperati solo i passaggi più rilevanti per ogni domanda.",
+    "kb.localNoteSub": "Ideale per linee guida cliniche, protocolli e PDF di riferimento. Gli embedding persistono tra i riavvii.",
+    "kb.localDropHint": "Trascina qui i documenti di riferimento",
+    "kb.localDropSubtext": "PDF · DOCX · TXT · MD",
+    "kb.localBrowse": "Sfoglia file",
+    "kb.localInjectLabel": "Inietta i documenti nel contesto dell'avatar alla connessione",
+    "clinical.title": "🩺 Referto esami del sangue",
+    "clinical.dropHint": "Trascina qui il tuo referto",
+    "clinical.dropSubtext": "PDF testuale — max 50 MB",
+    "clinical.browse": "Sfoglia file",
+    "clinical.analysing": "Analisi del referto…",
+    "telemetry.title": "📊 Costo sessione",
+    "telemetry.cost": "Costo stimato",
+    "telemetry.minutes": "Minuti fatturati",
+    "telemetry.sessions": "Sessioni",
+    "telemetry.live": "Sessione in corso",
+  },
+  fr: {
+    "lang.label": "Langue",
+    "header.subtitle": "Conversation en temps réel avec un persona IA Anam — avec questions sur vos documents",
+    "placeholder.text": "L'avatar apparaîtra ici",
+    "placeholder.hint": "Cliquez sur Connecter pour commencer",
+    "status.notConnected": "Non connecté",
+    "plan.free": "Gratuit · limite 2 min",
+    "plan.pro": "Pro · illimité",
+    "plan.banner": "Plan gratuit : l'avatar vous préviendra d'emblée que vous avez 2 minutes ensemble, affichera un compte à rebours en direct, et la session se déconnectera automatiquement à la fin du temps imparti.",
+    "persona.default": "— Par défaut éphémère —",
+    "controls.connect": "Connecter",
+    "controls.disconnect": "Déconnecter",
+    "advanced.toggle": "⚙ Avancé (system prompt)",
+    "advanced.clinicalPreset": "🩺 Préréglage Assistant clinique",
+    "advanced.systemPromptLabel": "System prompt (utilisé si aucun persona n'est sélectionné et RAG désactivé)",
+    "mode.voice": "🎙 Voix",
+    "mode.text": "⌨️ Texte",
+    "voice.hint": "Le microphone est actif — parlez à l'avatar",
+    "voice.hintMuted": "Microphone coupé — cliquez pour réactiver",
+    "text.placeholder": "Écrivez un message à l'avatar…",
+    "text.send": "Envoyer",
+    "kb.title": "📚 Base de connaissances",
+    "kb.cloudTab": "☁ Anam Cloud",
+    "kb.localTab": "💻 Local",
+    "kb.cloudNote": "Documents indexés dans le cloud d'Anam — l'avatar effectue une recherche à chaque tour",
+    "kb.reset": "Réinitialiser",
+    "kb.dropHint": "Déposez vos documents ici",
+    "kb.dropSubtext": "PDF · TXT · MD · DOCX · CSV — max 50 Mo",
+    "kb.browse": "Parcourir les fichiers",
+    "kb.uploading": "Téléversement…",
+    "kb.useRagLabel": "Utiliser la base de connaissances — l'avatar recherchera dans vos documents pour répondre",
+    "kb.editPrompt": "✏️ Modifier le comportement de l'assistant RAG (system prompt)",
+    "kb.promptLabel": "System prompt — contrôle comment l'avatar utilise la base de connaissances et répond aux questions générales",
+    "kb.applyPrompt": "Appliquer au persona",
+    "kb.promptHint": "Les modifications s'appliquent à la prochaine session que vous démarrez.",
+    "kb.localNote": "Documents découpés et vectorisés localement — seuls les passages les plus pertinents sont récupérés pour chaque question.",
+    "kb.localNoteSub": "Idéal pour les recommandations cliniques, protocoles et PDF de référence. Les embeddings persistent entre les redémarrages.",
+    "kb.localDropHint": "Déposez vos documents de référence ici",
+    "kb.localDropSubtext": "PDF · DOCX · TXT · MD",
+    "kb.localBrowse": "Parcourir les fichiers",
+    "kb.localInjectLabel": "Injecter les documents dans le contexte de l'avatar à la connexion",
+    "clinical.title": "🩺 Rapport d'analyse de sang",
+    "clinical.dropHint": "Déposez votre rapport d'analyse ici",
+    "clinical.dropSubtext": "PDF textuel — max 50 Mo",
+    "clinical.browse": "Parcourir les fichiers",
+    "clinical.analysing": "Analyse du rapport…",
+    "telemetry.title": "📊 Coût de la session",
+    "telemetry.cost": "Coût estimé",
+    "telemetry.minutes": "Minutes facturées",
+    "telemetry.sessions": "Sessions",
+    "telemetry.live": "Session en direct",
+  },
+  es: {
+    "lang.label": "Idioma",
+    "header.subtitle": "Conversación en tiempo real con una persona de IA de Anam — con preguntas sobre documentos",
+    "placeholder.text": "El avatar aparecerá aquí",
+    "placeholder.hint": "Haz clic en Conectar para empezar",
+    "status.notConnected": "No conectado",
+    "plan.free": "Gratis · límite 2 min",
+    "plan.pro": "Pro · ilimitado",
+    "plan.banner": "Plan gratuito: el avatar te avisará de antemano de que tenéis 2 minutos juntos, mostrará una cuenta atrás en vivo y la sesión se desconectará automáticamente cuando se acabe el tiempo.",
+    "persona.default": "— Predeterminado efímero —",
+    "controls.connect": "Conectar",
+    "controls.disconnect": "Desconectar",
+    "advanced.toggle": "⚙ Avanzado (system prompt)",
+    "advanced.clinicalPreset": "🩺 Preajuste Asistente clínico",
+    "advanced.systemPromptLabel": "System prompt (usado cuando no hay persona seleccionada y RAG está desactivado)",
+    "mode.voice": "🎙 Voz",
+    "mode.text": "⌨️ Texto",
+    "voice.hint": "El micrófono está activo — habla con el avatar",
+    "voice.hintMuted": "Micrófono silenciado — haz clic para reactivar",
+    "text.placeholder": "Escribe un mensaje al avatar…",
+    "text.send": "Enviar",
+    "kb.title": "📚 Base de conocimiento",
+    "kb.cloudTab": "☁ Anam Cloud",
+    "kb.localTab": "💻 Local",
+    "kb.cloudNote": "Documentos indexados en la nube de Anam — el avatar busca en cada turno",
+    "kb.reset": "Restablecer",
+    "kb.dropHint": "Suelta los documentos aquí",
+    "kb.dropSubtext": "PDF · TXT · MD · DOCX · CSV — máx. 50 MB",
+    "kb.browse": "Examinar archivos",
+    "kb.uploading": "Subiendo…",
+    "kb.useRagLabel": "Usar la base de conocimiento — el avatar buscará en tus documentos al responder",
+    "kb.editPrompt": "✏️ Editar comportamiento del asistente RAG (system prompt)",
+    "kb.promptLabel": "System prompt — controla cómo el avatar usa la base de conocimiento y responde preguntas generales",
+    "kb.applyPrompt": "Aplicar a la persona",
+    "kb.promptHint": "Los cambios se aplican en la próxima sesión que inicies.",
+    "kb.localNote": "Documentos fragmentados y vectorizados localmente — solo se recuperan los pasajes más relevantes para cada pregunta.",
+    "kb.localNoteSub": "Ideal para guías clínicas, protocolos y PDF de referencia. Los embeddings persisten entre reinicios.",
+    "kb.localDropHint": "Suelta aquí los documentos de referencia",
+    "kb.localDropSubtext": "PDF · DOCX · TXT · MD",
+    "kb.localBrowse": "Examinar archivos",
+    "kb.localInjectLabel": "Inyectar documentos en el contexto del avatar al conectar",
+    "clinical.title": "🩺 Informe de análisis de sangre",
+    "clinical.dropHint": "Suelta aquí tu informe de análisis",
+    "clinical.dropSubtext": "PDF de texto — máx. 50 MB",
+    "clinical.browse": "Examinar archivos",
+    "clinical.analysing": "Analizando el informe…",
+    "telemetry.title": "📊 Coste de la sesión",
+    "telemetry.cost": "Coste estimado",
+    "telemetry.minutes": "Minutos facturados",
+    "telemetry.sessions": "Sesiones",
+    "telemetry.live": "Sesión en vivo",
+  },
+  de: {
+    "lang.label": "Sprache",
+    "header.subtitle": "Echtzeit-Gespräch mit einer Anam-KI-Persona — mit Fragen zu Dokumenten",
+    "placeholder.text": "Der Avatar erscheint hier",
+    "placeholder.hint": "Klicke auf Verbinden, um zu starten",
+    "status.notConnected": "Nicht verbunden",
+    "plan.free": "Kostenlos · 2 Min. Limit",
+    "plan.pro": "Pro · unbegrenzt",
+    "plan.banner": "Kostenloser Plan: Der Avatar teilt euch vorab mit, dass ihr 2 Minuten zusammen habt, zeigt einen Live-Countdown, und die Sitzung wird automatisch getrennt, wenn die Zeit abgelaufen ist.",
+    "persona.default": "— Standard, flüchtig —",
+    "controls.connect": "Verbinden",
+    "controls.disconnect": "Trennen",
+    "advanced.toggle": "⚙ Erweitert (System-Prompt)",
+    "advanced.clinicalPreset": "🩺 Voreinstellung Klinischer Assistent",
+    "advanced.systemPromptLabel": "System-Prompt (verwendet, wenn keine Persona ausgewählt und RAG deaktiviert ist)",
+    "mode.voice": "🎙 Sprache",
+    "mode.text": "⌨️ Text",
+    "voice.hint": "Mikrofon ist aktiv — sprich mit dem Avatar",
+    "voice.hintMuted": "Mikrofon stummgeschaltet — klicken zum Aktivieren",
+    "text.placeholder": "Nachricht an den Avatar eingeben…",
+    "text.send": "Senden",
+    "kb.title": "📚 Wissensdatenbank",
+    "kb.cloudTab": "☁ Anam Cloud",
+    "kb.localTab": "💻 Lokal",
+    "kb.cloudNote": "Dokumente in der Anam-Cloud indexiert — der Avatar sucht bei jedem Zug",
+    "kb.reset": "Zurücksetzen",
+    "kb.dropHint": "Dokumente hierher ziehen",
+    "kb.dropSubtext": "PDF · TXT · MD · DOCX · CSV — max. 50 MB",
+    "kb.browse": "Dateien durchsuchen",
+    "kb.uploading": "Wird hochgeladen…",
+    "kb.useRagLabel": "Wissensdatenbank verwenden — der Avatar durchsucht deine Dokumente bei der Antwort",
+    "kb.editPrompt": "✏️ Verhalten des RAG-Assistenten bearbeiten (System-Prompt)",
+    "kb.promptLabel": "System-Prompt — steuert, wie der Avatar die Wissensdatenbank nutzt und allgemeine Fragen beantwortet",
+    "kb.applyPrompt": "Auf Persona anwenden",
+    "kb.promptHint": "Änderungen gelten ab der nächsten Sitzung, die du startest.",
+    "kb.localNote": "Dokumente werden lokal zerlegt und eingebettet — pro Frage werden nur die relevantesten Passagen abgerufen.",
+    "kb.localNoteSub": "Ideal für klinische Leitlinien, Protokolle und Referenz-PDFs. Embeddings bleiben über Neustarts hinweg erhalten.",
+    "kb.localDropHint": "Referenzdokumente hierher ziehen",
+    "kb.localDropSubtext": "PDF · DOCX · TXT · MD",
+    "kb.localBrowse": "Dateien durchsuchen",
+    "kb.localInjectLabel": "Dokumente beim Verbinden in den Kontext des Avatars einfügen",
+    "clinical.title": "🩺 Blutbild-Bericht",
+    "clinical.dropHint": "Blutbild-Bericht hierher ziehen",
+    "clinical.dropSubtext": "Text-basiertes PDF — max. 50 MB",
+    "clinical.browse": "Dateien durchsuchen",
+    "clinical.analysing": "Bericht wird analysiert…",
+    "telemetry.title": "📊 Sitzungskosten",
+    "telemetry.cost": "Geschätzte Kosten",
+    "telemetry.minutes": "Abgerechnete Minuten",
+    "telemetry.sessions": "Sitzungen",
+    "telemetry.live": "Laufende Sitzung",
+  },
+};
+
+function normalize(locale) {
+  return LOCALES.includes(locale) ? locale : "en";
+}
+
+export function getLocale() {
+  return normalize(localStorage.getItem(STORAGE_KEY));
+}
+
+export function setLocale(locale) {
+  localStorage.setItem(STORAGE_KEY, normalize(locale));
+}
+
+/** Look up a single translation key for the current locale (falls back to English). */
+export function t(key) {
+  const locale = getLocale();
+  return T[locale]?.[key] ?? T.en[key] ?? key;
+}
+
+/**
+ * Apply the current locale to every element in the document carrying:
+ *  - data-i18n="key"             → sets textContent
+ *  - data-i18n-placeholder="key" → sets the placeholder attribute
+ *  - data-i18n-title="key"       → sets the title attribute
+ * Also updates <html lang="...">.
+ */
+export function applyTranslations() {
+  const locale = getLocale();
+  document.documentElement.lang = locale;
+
+  document.querySelectorAll("[data-i18n]").forEach((el) => {
+    el.textContent = t(el.dataset.i18n);
+  });
+  document.querySelectorAll("[data-i18n-placeholder]").forEach((el) => {
+    el.placeholder = t(el.dataset.i18nPlaceholder);
+  });
+  document.querySelectorAll("[data-i18n-title]").forEach((el) => {
+    el.title = t(el.dataset.i18nTitle);
+  });
+}

anam/static/js/kb.js

@@ -2,6 +2,7 @@ import {
   deleteRagDocument, getRagDocuments, getRagPrompt, getRagStatus,
   resetRag, updateRagPrompt, uploadRagFile,
 } from "./api.js";
+import { getLocale } from "./i18n.js";
 
 // ── Shared state (live bindings — app.js reads these directly) ────────────────
 export let ragSetupReady = false;
@@ -195,7 +196,7 @@ applyRagBtn.addEventListener("click", async () => {
   applyRagBtn.disabled      = true;
   ragPromptHint.textContent = "Saving…";
   try {
-    await updateRagPrompt(prompt);
+    await updateRagPrompt(prompt, getLocale());
     ragPromptHint.textContent = "✓ Saved — reconnect for changes to take effect.";
   } catch (e) {
     ragPromptHint.textContent = "Save failed: " + e.message;