Update documentation and configuration to reflect the transition from 'friend-backend' to 'chronicle-backend' across various files, including setup instructions, Docker configurations, and service logs.

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

@@ -210,7 +210,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/Caddyfile.template

@@ -19,7 +19,7 @@ localhost TAILSCALE_IP {
 
     # WebSocket endpoints - proxy to backend with upgrade support
     handle /ws* {
-        reverse_proxy friend-backend:8000 {
+        reverse_proxy chronicle-backend:8000 {
             # Caddy automatically handles WebSocket upgrades
             header_up X-Real-IP {remote_host}
             header_up X-Forwarded-For {remote_host}
@@ -29,31 +29,31 @@ localhost TAILSCALE_IP {
 
     # API endpoints - proxy to backend
     handle /api/* {
-        reverse_proxy friend-backend:8000
+        reverse_proxy chronicle-backend:8000
     }
 
     # Auth endpoints - proxy to backend
     handle /auth/* {
-        reverse_proxy friend-backend:8000
+        reverse_proxy chronicle-backend:8000
     }
 
     # Health checks - proxy to backend
     handle /health {
-        reverse_proxy friend-backend:8000
+        reverse_proxy chronicle-backend:8000
     }
 
     handle /readiness {
-        reverse_proxy friend-backend:8000
+        reverse_proxy chronicle-backend:8000
     }
 
     # Users endpoints - proxy to backend
     handle /users/* {
-        reverse_proxy friend-backend:8000
+        reverse_proxy chronicle-backend:8000
     }
 
     # Audio files - proxy to backend
     handle /audio/* {
-        reverse_proxy friend-backend:8000
+        reverse_proxy chronicle-backend:8000
     }
 
     # Everything else - proxy to webui
@@ -68,36 +68,36 @@ localhost TAILSCALE_IP {
 #
 #     # WebSocket endpoints
 #     handle /ws* {
-#         reverse_proxy friend-backend:8000
+#         reverse_proxy chronicle-backend:8000
 #     }
 #
 #     # API endpoints
 #     handle /api/* {
-#         reverse_proxy friend-backend:8000
+#         reverse_proxy chronicle-backend:8000
 #     }
 #
 #     # Auth endpoints
 #     handle /auth/* {
-#         reverse_proxy friend-backend:8000
+#         reverse_proxy chronicle-backend:8000
 #     }
 #
 #     # Health checks
 #     handle /health {
-#         reverse_proxy friend-backend:8000
+#         reverse_proxy chronicle-backend:8000
 #     }
 #
 #     handle /readiness {
-#         reverse_proxy friend-backend:8000
+#         reverse_proxy chronicle-backend:8000
 #     }
 #
 #     # Users endpoints
 #     handle /users/* {
-#         reverse_proxy friend-backend:8000
+#         reverse_proxy chronicle-backend:8000
 #     }
 #
 #     # Audio files
 #     handle /audio/* {
-#         reverse_proxy friend-backend:8000
+#         reverse_proxy chronicle-backend:8000
 #     }
 #
 #     # Everything else - webui

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 `memory_config.yaml` 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`