Merge branch 'dev' into fix/cleanup-model

Author: AnkushMalaker

.github/workflows/robot-tests.yml

@@ -141,7 +141,7 @@ jobs:
           # Show logs every 10 attempts to help debug
           if [ $((i % 10)) -eq 0 ]; then
             echo "Still waiting... showing recent logs:"
-            docker compose -f docker-compose-test.yml logs --tail=20 friend-backend-test
+            docker compose -f docker-compose-test.yml logs --tail=20 chronicle-backend-test
           fi
           if [ $i -eq 40 ]; then
             echo "✗ Backend failed to start - showing full logs:"
@@ -219,7 +219,7 @@ jobs:
       working-directory: backends/advanced
       run: |
         echo "=== Backend Logs (last 50 lines) ==="
-        docker compose -f docker-compose-test.yml logs --tail=50 friend-backend-test
+        docker compose -f docker-compose-test.yml logs --tail=50 chronicle-backend-test
         echo ""
         echo "=== Worker Logs (last 50 lines) ==="
         docker compose -f docker-compose-test.yml logs --tail=50 workers-test

CLAUDE.md

@@ -13,6 +13,49 @@ This supports a comprehensive web dashboard for management.
 
 **❌ No Backward Compatibility**: Do NOT add backward compatibility code unless explicitly requested. This includes fallback logic, legacy field support, or compatibility layers. Always ask before adding backward compatibility - in most cases the answer is no during active development.
 
+## Initial Setup & Configuration
+
+Chronicle includes an **interactive setup wizard** for easy configuration. The wizard guides you through:
+- Service selection (backend + optional services)
+- Authentication setup (admin account, JWT secrets)
+- Transcription provider configuration (Deepgram, Mistral, or offline ASR)
+- LLM provider setup (OpenAI or Ollama)
+- Memory provider selection (Chronicle Native with Qdrant or OpenMemory MCP)
+- Network configuration and HTTPS setup
+- Optional services (speaker recognition, Parakeet ASR)
+
+### Quick Start
+```bash
+# Run the interactive setup wizard from project root
+uv run python wizard.py
+
+# Or use the quickstart guide for step-by-step instructions
+# See quickstart.md for detailed walkthrough
+```
+
+### Setup Documentation
+For detailed setup instructions and troubleshooting, see:
+- **[@quickstart.md](quickstart.md)**: Beginner-friendly step-by-step setup guide
+- **[@Docs/init-system.md](Docs/init-system.md)**: Complete initialization system architecture and design
+- **[@Docs/getting-started.md](Docs/getting-started.md)**: Technical quickstart with advanced configuration
+- **[@backends/advanced/SETUP_SCRIPTS.md](backends/advanced/SETUP_SCRIPTS.md)**: Setup scripts reference and usage examples
+- **[@backends/advanced/Docs/quickstart.md](backends/advanced/Docs/quickstart.md)**: Backend-specific setup guide
+
+### Wizard Architecture
+The initialization system uses a **root orchestrator pattern**:
+- **`wizard.py`**: Root setup orchestrator for service selection and delegation
+- **`backends/advanced/init.py`**: Backend configuration wizard
+- **`extras/speaker-recognition/init.py`**: Speaker recognition setup
+- **Service setup scripts**: Individual setup for ASR services and OpenMemory MCP
+
+Key features:
+- Interactive prompts with validation
+- API key masking and secure credential handling
+- Environment file generation with placeholders
+- HTTPS configuration with SSL certificate generation
+- Service status display and health checks
+- Automatic backup of existing configurations
+
 ## Development Commands
 
 ### Backend Development (Advanced Backend - Primary)

Docs/getting-started.md

@@ -396,7 +396,7 @@ uv sync --group (whatever group you want to sync)
 ## Troubleshooting
 
 **Service Issues:**
-- Check logs: `docker compose logs friend-backend`
+- Check logs: `docker compose logs chronicle-backend`
 - Restart services: `docker compose restart`
 - View all services: `docker compose ps`
 

Docs/init-system.md

@@ -230,7 +230,7 @@ curl http://localhost:8767/health
 docker compose logs [service-name]
 
 # Backend logs
-cd backends/advanced && docker compose logs friend-backend
+cd backends/advanced && docker compose logs chronicle-backend
 
 # Speaker Recognition logs
 cd extras/speaker-recognition && docker compose logs speaker-service

backends/advanced/Docs/HTTPS_SETUP.md

@@ -89,7 +89,7 @@ CORS_ORIGINS=https://localhost,https://127.0.0.1,https://100.83.66.30
 **Services started:**
 - ✅ nginx (ports 443/80) - SSL termination and proxy
 - ✅ webui (port 5173, internal) - Vite dev server  
-- ✅ friend-backend (port 8000, internal)
+- ✅ chronicle-backend (port 8000, internal)
 - ✅ mongo, qdrant (databases)
 
 **Access:** https://localhost/ or https://your-ip/  
@@ -99,7 +99,7 @@ CORS_ORIGINS=https://localhost,https://127.0.0.1,https://100.83.66.30
 **Services started:**
 - ✅ nginx (ports 443/80) - but without SSL certificates
 - ✅ webui (port 5173, direct access) - Vite dev server
-- ✅ friend-backend (port 8000)
+- ✅ chronicle-backend (port 8000)
 - ✅ mongo, qdrant (databases)
 
 **Access:** http://localhost:5173  
@@ -169,7 +169,7 @@ docker compose restart nginx
 **Problem:** "Cross-Origin Request Blocked"
 **Solution:**
 1. Update CORS_ORIGINS in `.env` to include your HTTPS origin
-2. Restart backend: `docker compose restart friend-backend`
+2. Restart backend: `docker compose restart chronicle-backend`
 
 ### Microphone Access Denied
 
@@ -192,7 +192,7 @@ docker compose restart nginx
 ### Standard Setup
 - **3000** - HTTP (webui production)
 - **5173** - HTTP (webui development)
-- **8000** - HTTP (friend-backend)
+- **8000** - HTTP (chronicle-backend)
 
 ## Live Recording Feature
 

backends/advanced/Docs/README.md

@@ -189,7 +189,7 @@ backends/advanced-backend/
 
 - **Debug API**: `GET /api/debug/memory/*` endpoints show real-time system status
 - **Configuration**: Check `config.yml` for behavior controls
-- **Logs**: Check Docker logs with `docker compose logs friend-backend`
+- **Logs**: Check Docker logs with `docker compose logs chronicle-backend`
 - **Documentation**: Each doc file links to relevant code sections
 
 ---

backends/advanced/Docs/architecture.md

@@ -585,7 +585,7 @@ stateDiagram-v2
 ```mermaid
 graph LR
     subgraph "Docker Network"
-        Backend[friend-backend<br/>uv + FastAPI]
+        Backend[chronicle-backend<br/>uv + FastAPI]
         WebUI[webui<br/>React Dashboard]
         Proxy[nginx<br/>Load Balancer]
         Mongo[mongo:4.4.18<br/>Primary Database]
@@ -616,7 +616,7 @@ graph LR
 
 ### Container Specifications
 
-#### Backend Container (`friend-backend`)
+#### Backend Container (`chronicle-backend`)
 - **Base**: Python 3.12 slim with uv package manager
 - **Dependencies**: FastAPI, WebSocket libraries, audio processing tools
 - **Volumes**: Audio chunk storage, debug directories

backends/advanced/Docs/auth.md

@@ -260,7 +260,7 @@ curl -X POST "http://localhost:8000/auth/jwt/login" \
 #### 3. Admin User Creation
 ```bash
 # Check logs for admin creation
-docker compose logs friend-backend | grep -i admin
+docker compose logs chronicle-backend | grep -i admin
 
 # Verify environment variables
 echo $ADMIN_PASSWORD
@@ -272,7 +272,7 @@ echo $ADMIN_PASSWORD
 docker exec -it mongo-container mongosh chronicle
 
 # View authentication logs
-docker compose logs friend-backend | grep -i auth
+docker compose logs chronicle-backend | grep -i auth
 
 # Test API endpoints
 curl -H "Authorization: Bearer $TOKEN" http://localhost:8000/api/users/me

backends/advanced/Docs/quickstart.md

@@ -394,7 +394,7 @@ uv sync --group (whatever group you want to sync)
 ## Troubleshooting
 
 **Service Issues:**
-- Check logs: `docker compose logs friend-backend`
+- Check logs: `docker compose logs chronicle-backend`
 - Restart services: `docker compose restart`
 - View all services: `docker compose ps`
 

backends/advanced/nginx.conf.template

@@ -43,8 +43,8 @@ http {
     }
 
     # Upstream services
-    upstream friend_backend {
-        server friend-backend:8000;
+    upstream chronicle_backend {
+        server chronicle-backend:8000;
     }
 
     upstream friend_webui {
@@ -70,7 +70,7 @@ http {
 
         # Backend API endpoints
         location /api/ {
-            proxy_pass http://friend_backend/api/;
+            proxy_pass http://chronicle_backend/api/;
             proxy_set_header Host $host;
             proxy_set_header X-Real-IP $remote_addr;
             proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
@@ -80,7 +80,7 @@ http {
 
         # Authentication endpoints
         location /auth/ {
-            proxy_pass http://friend_backend/auth/;
+            proxy_pass http://chronicle_backend/auth/;
             proxy_set_header Host $host;
             proxy_set_header X-Real-IP $remote_addr;
             proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
@@ -90,7 +90,7 @@ http {
 
         # Users endpoints
         location /users/ {
-            proxy_pass http://friend_backend/users/;
+            proxy_pass http://chronicle_backend/users/;
             proxy_set_header Host $host;
             proxy_set_header X-Real-IP $remote_addr;
             proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
@@ -100,7 +100,7 @@ http {
 
         # WebSocket endpoints for audio streaming
         location /ws_pcm {
-            proxy_pass http://friend_backend/ws_pcm;
+            proxy_pass http://chronicle_backend/ws_pcm;
             proxy_http_version 1.1;
             proxy_set_header Upgrade $http_upgrade;
             proxy_set_header Connection $connection_upgrade;
@@ -117,7 +117,7 @@ http {
         }
 
         location /ws_omi {
-            proxy_pass http://friend_backend/ws_omi;
+            proxy_pass http://chronicle_backend/ws_omi;
             proxy_http_version 1.1;
             proxy_set_header Upgrade $http_upgrade;
             proxy_set_header Connection $connection_upgrade;
@@ -135,7 +135,7 @@ http {
 
         # Legacy WebSocket endpoint
         location /ws {
-            proxy_pass http://friend_backend/ws;
+            proxy_pass http://chronicle_backend/ws;
             proxy_http_version 1.1;
             proxy_set_header Upgrade $http_upgrade;
             proxy_set_header Connection $connection_upgrade;
@@ -153,7 +153,7 @@ http {
 
         # Health check endpoints
         location /health {
-            proxy_pass http://friend_backend/health;
+            proxy_pass http://chronicle_backend/health;
             proxy_set_header Host $host;
             proxy_set_header X-Real-IP $remote_addr;
             proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
@@ -162,7 +162,7 @@ http {
 
         # Readiness check endpoint
         location /readiness {
-            proxy_pass http://friend_backend/readiness;
+            proxy_pass http://chronicle_backend/readiness;
             proxy_set_header Host $host;
             proxy_set_header X-Real-IP $remote_addr;
             proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
@@ -171,7 +171,7 @@ http {
 
         # Audio file serving
         location /audio/ {
-            proxy_pass http://friend_backend/audio/;
+            proxy_pass http://chronicle_backend/audio/;
             proxy_set_header Host $host;
             proxy_set_header X-Real-IP $remote_addr;
             proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;