Convers | System Architecture

Overview

Convers is a **Sovereign AI Application**. Unlike typical SaaS tools, it runs entirely on your own infrastructure (or a secure private cloud). It does not send patient data to third-party aggregators.

Frontend

Pure HTML5/JS (No Framework Bloat)
Three.js Somatic Orb Engine
WebSpeech API for Voice I/O
Tailwind CSS for Styling

Backend

Python FastAPI Server
Stateful Session Memory
Stealth LLM Driver (Headless Browser)
Modular Prompt System

Configuration (BYO Keys)

By default, Convers uses a **Stealth Driver** to access AI models without API keys. For production reliability or HIPAA compliance, you can configure it to use your own secure API endpoints.

1. Environment Setup

Create a `.env` file in the `api/` directory:

# api/.env

# Optional: Use OpenAI/Anthropic instead of Stealth Mode
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...

# System Settings
LOG_LEVEL=INFO
SESSION_TIMEOUT=3600

2. Prompt Engineering

Edit the clinical personas in `api/prompts/` to tune the simulation:

api/prompts/client_alex.txt - The Anxious Patient Persona
api/prompts/supervisor_ulrich.txt - The Clinical Auditor Persona

Developer Notes

The 3D Orb is procedurally generated using Perlin noise mapped to an Icosahedron geometry. It reacts to "State" (Listening, Thinking, Speaking) by interpolating between color targets (`lerp`).

Voice synthesis prioritizes local high-quality voices ("Samantha", "Nadia") to minimize latency.