# microsoft-foundry/voicelive-samples architecture

> Architecture diagram of the GitHub repository microsoft-foundry/voicelive-samples, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/microsoft-foundry/voicelive-samples
- Repository: https://github.com/microsoft-foundry/voicelive-samples

## Overview

This repository is a multilingual collection of Azure AI Speech Voice Live samples, rather than one deployed application. The main user journey is to choose a language and scenario, configure Azure resources, run a sample, and explore a live voice interaction. The graph highlights direct model/agent quickstarts, browser experiences, and larger full-stack demonstrations, including RAG, avatar, interpreter, and universal-assistant paths. README-described capabilities are retained; source-level edges are limited to relationships visible in the supplied index or excerpts.

Main entry points: [`voice-live-universal-assistant/frontend/src/hooks/useVoiceSession.ts`](https://github.com/microsoft-foundry/voicelive-samples/blob/main/voice-live-universal-assistant/frontend/src/hooks/useVoiceSession.ts) (Voice Session Hook), [`python/voice-live-voicerag-assistant/app/backend/app.py`](https://github.com/microsoft-foundry/voicelive-samples/blob/main/python/voice-live-voicerag-assistant/app/backend/app.py) (Voice RAG Assistant), [`csharp/voice-live-quickstarts`](https://github.com/microsoft-foundry/voicelive-samples/tree/main/csharp/voice-live-quickstarts) (C# Quickstarts), [`python/voice-live-quickstarts`](https://github.com/microsoft-foundry/voicelive-samples/tree/main/python/voice-live-quickstarts) (Python Quickstarts)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_quickstarts["Voice Live Quickstarts"]
  node_csharp_quickstarts["C&#35; Quickstarts"]
  node_python_quickstarts["Python Quickstarts"]
  node_js_quickstarts["JavaScript Quickstarts"]
  node_java_quickstarts["Java Quickstarts"]
end

subgraph group_browser["Browser Experiences"]
  node_basic_assistant["Web Voice Assistant<br/>[voiceAssistant.ts]"]
  node_education["Education Coach<br/>[voiceAssistant.ts]"]
  node_aec["Reference AEC<br/>[voiceAssistant.ts]"]
  node_interpreter["Live Interpreter"]
  node_rag_frontend["RAG Frontend<br/>[App.tsx]"]
  node_universal_ui["Universal Assistant UI<br/>[App.tsx]"]
  node_universal_session["Voice Session Hook<br/>[useVoiceSession.ts]"]
end

subgraph group_applications["Full-stack Applications"]
  node_customer_bot["Customer Service Bot"]
  node_customer_functions["Customer Functions"]
  node_audio_processor["Audio Processor<br/>[AudioProcessor.cs]"]
  node_car_demo["Car Assistant<br/>[App.jsx]"]
  node_car_tools["Car Tools<br/>[carTools.js]"]
  node_rag_app["Voice RAG Assistant<br/>[app.py]"]
  node_avatar_app["Avatar Application<br/>[app.py]"]
  node_trader["Trading Assistant<br/>[traderAgent.ts]"]
end

subgraph group_service["Service Integrations"]
  node_rag_web["RAG Web Handler<br/>[web_handler.py]"]
  node_rag_tools["RAG Tool Loader<br/>[tool_loader.py]"]
  node_avatar_handler["Avatar Voice Handler<br/>[voice_handler.py]"]
  node_universal_python["Python WebSocket Backend<br/>[app.py]"]
  node_universal_csharp["C&#35; WebSocket Backend<br/>[Program.cs]"]
  node_universal_js["JavaScript Backend<br/>[app.js]"]
end

subgraph group_guided["Guided Development"]
  node_avatar_skill["Avatar Integration Skill"]
end

node_developer(("Sample User"))
node_azure{{"Azure Voice Live"}}
node_foundry{{"AI Foundry Agents"}}
node_search[("Azure AI Search")]

node_developer -->|"chooses and runs"| node_csharp_quickstarts
node_developer -->|"chooses and runs"| node_python_quickstarts
node_developer -->|"chooses and runs"| node_js_quickstarts
node_developer -->|"chooses and runs"| node_java_quickstarts
node_csharp_quickstarts -->|"integrates with"| node_azure
node_python_quickstarts -->|"integrates with"| node_azure
node_js_quickstarts -->|"integrates with"| node_azure
node_java_quickstarts -->|"integrates with"| node_azure
node_csharp_quickstarts -->|"connects agents"| node_foundry
node_python_quickstarts -->|"connects agents"| node_foundry
node_js_quickstarts -->|"connects agents"| node_foundry
node_java_quickstarts -->|"connects agents"| node_foundry
node_customer_bot -->|"uses functions"| node_customer_functions
node_customer_bot -->|"uses audio"| node_audio_processor
node_basic_assistant -->|"streams voice"| node_azure
node_education -->|"assesses speech"| node_azure
node_aec -->|"streams reference audio"| node_azure
node_interpreter -->|"translates speech"| node_azure
node_car_demo -->|"executes tools"| node_car_tools
node_car_demo -->|"connects voice"| node_azure
node_rag_app -->|"routes sessions"| node_rag_web
node_rag_app -->|"loads tools"| node_rag_tools
node_rag_frontend -->|"uses backend"| node_rag_app
node_rag_app -->|"retrieves knowledge"| node_search
node_avatar_app -->|"creates handler"| node_avatar_handler
node_avatar_handler -->|"manages sessions"| node_azure
node_universal_ui -->|"uses session hook"| node_universal_session
node_universal_session -->|"connects backend"| node_universal_python
node_universal_session -->|"connects backend"| node_universal_csharp
node_universal_session -.->|"connects backend"| node_universal_js
node_universal_python -->|"proxies sessions"| node_azure
node_universal_csharp -->|"proxies sessions"| node_azure
node_universal_js -->|"proxies sessions"| node_azure
node_trader -->|"supports trading voice"| node_azure
node_developer -->|"uses guidance"| node_avatar_skill

click node_csharp_quickstarts "https://github.com/microsoft-foundry/voicelive-samples/tree/main/csharp/voice-live-quickstarts"
click node_python_quickstarts "https://github.com/microsoft-foundry/voicelive-samples/tree/main/python/voice-live-quickstarts"
click node_js_quickstarts "https://github.com/microsoft-foundry/voicelive-samples/tree/main/javascript/voice-live-quickstarts"
click node_java_quickstarts "https://github.com/microsoft-foundry/voicelive-samples/tree/main/java/voice-live-quickstarts"
click node_customer_bot "https://github.com/microsoft-foundry/voicelive-samples/blob/main/csharp/CustomerServiceBot/CustomerServiceBot.cs"
click node_customer_functions "https://github.com/microsoft-foundry/voicelive-samples/blob/main/csharp/CustomerServiceBot/CustomerServiceFunctions.cs"
click node_audio_processor "https://github.com/microsoft-foundry/voicelive-samples/blob/main/csharp/CustomerServiceBot/AudioProcessor.cs"
click node_basic_assistant "https://github.com/microsoft-foundry/voicelive-samples/blob/main/javascript/basic-web-voice-assistant/src/voiceAssistant.ts"
click node_education "https://github.com/microsoft-foundry/voicelive-samples/blob/main/javascript/voice-live-education-demo/src/voiceAssistant.ts"
click node_aec "https://github.com/microsoft-foundry/voicelive-samples/blob/main/javascript/live-reference-aec/src/voiceAssistant.ts"
click node_interpreter "https://github.com/microsoft-foundry/voicelive-samples/blob/main/javascript/voice-live-interpreter-demo/src/lib/voiceLiveInterpreter.ts"
click node_car_demo "https://github.com/microsoft-foundry/voicelive-samples/blob/main/javascript/voice-live-car-demo/src/App.jsx"
click node_car_tools "https://github.com/microsoft-foundry/voicelive-samples/blob/main/javascript/voice-live-car-demo/src/tools/carTools.js"
click node_rag_app "https://github.com/microsoft-foundry/voicelive-samples/blob/main/python/voice-live-voicerag-assistant/app/backend/app.py"
click node_rag_web "https://github.com/microsoft-foundry/voicelive-samples/blob/main/python/voice-live-voicerag-assistant/app/backend/web_handler.py"
click node_rag_tools "https://github.com/microsoft-foundry/voicelive-samples/blob/main/python/voice-live-voicerag-assistant/app/backend/tool_loader.py"
click node_rag_frontend "https://github.com/microsoft-foundry/voicelive-samples/blob/main/python/voice-live-voicerag-assistant/app/frontend/src/App.tsx"
click node_avatar_app "https://github.com/microsoft-foundry/voicelive-samples/blob/main/python/voice-live-avatar/app.py"
click node_avatar_handler "https://github.com/microsoft-foundry/voicelive-samples/blob/main/python/voice-live-avatar/voice_handler.py"
click node_universal_ui "https://github.com/microsoft-foundry/voicelive-samples/blob/main/voice-live-universal-assistant/frontend/src/App.tsx"
click node_universal_session "https://github.com/microsoft-foundry/voicelive-samples/blob/main/voice-live-universal-assistant/frontend/src/hooks/useVoiceSession.ts"
click node_universal_python "https://github.com/microsoft-foundry/voicelive-samples/blob/main/voice-live-universal-assistant/python/app.py"
click node_universal_csharp "https://github.com/microsoft-foundry/voicelive-samples/blob/main/voice-live-universal-assistant/csharp/Program.cs"
click node_universal_js "https://github.com/microsoft-foundry/voicelive-samples/blob/main/voice-live-universal-assistant/javascript/app.js"
click node_trader "https://github.com/microsoft-foundry/voicelive-samples/blob/main/javascript/voice-live-trader-demo/src/lib/traderAgent.ts"
click node_avatar_skill "https://github.com/microsoft-foundry/voicelive-samples/tree/main/skills/azure-avatar-integrate"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_csharp_quickstarts,node_python_quickstarts,node_js_quickstarts,node_java_quickstarts,node_developer toneBlue
class node_basic_assistant,node_education,node_aec,node_interpreter,node_rag_frontend,node_universal_ui,node_universal_session,node_search toneAmber
class node_customer_bot,node_customer_functions,node_audio_processor,node_car_demo,node_car_tools,node_rag_app,node_avatar_app,node_trader toneMint
class node_rag_web,node_rag_tools,node_avatar_handler,node_universal_python,node_universal_csharp,node_universal_js toneRose
class node_avatar_skill,node_azure,node_foundry toneIndigo
```

## Components

### Voice Live Quickstarts

- [C# Quickstarts](https://github.com/microsoft-foundry/voicelive-samples/tree/main/csharp/voice-live-quickstarts): `csharp/voice-live-quickstarts`
- [Python Quickstarts](https://github.com/microsoft-foundry/voicelive-samples/tree/main/python/voice-live-quickstarts): `python/voice-live-quickstarts`
- [JavaScript Quickstarts](https://github.com/microsoft-foundry/voicelive-samples/tree/main/javascript/voice-live-quickstarts): `javascript/voice-live-quickstarts`
- [Java Quickstarts](https://github.com/microsoft-foundry/voicelive-samples/tree/main/java/voice-live-quickstarts): `java/voice-live-quickstarts`

### Browser Experiences

- [Web Voice Assistant](https://github.com/microsoft-foundry/voicelive-samples/blob/main/javascript/basic-web-voice-assistant/src/voiceAssistant.ts): `javascript/basic-web-voice-assistant/src/voiceAssistant.ts`
- [Education Coach](https://github.com/microsoft-foundry/voicelive-samples/blob/main/javascript/voice-live-education-demo/src/voiceAssistant.ts): `javascript/voice-live-education-demo/src/voiceAssistant.ts`
- [Reference AEC](https://github.com/microsoft-foundry/voicelive-samples/blob/main/javascript/live-reference-aec/src/voiceAssistant.ts): `javascript/live-reference-aec/src/voiceAssistant.ts`
- [Live Interpreter](https://github.com/microsoft-foundry/voicelive-samples/blob/main/javascript/voice-live-interpreter-demo/src/lib/voiceLiveInterpreter.ts): `javascript/voice-live-interpreter-demo/src/lib/voiceLiveInterpreter.ts`
- [RAG Frontend](https://github.com/microsoft-foundry/voicelive-samples/blob/main/python/voice-live-voicerag-assistant/app/frontend/src/App.tsx): `python/voice-live-voicerag-assistant/app/frontend/src/App.tsx`
- [Universal Assistant UI](https://github.com/microsoft-foundry/voicelive-samples/blob/main/voice-live-universal-assistant/frontend/src/App.tsx): `voice-live-universal-assistant/frontend/src/App.tsx`
- [Voice Session Hook](https://github.com/microsoft-foundry/voicelive-samples/blob/main/voice-live-universal-assistant/frontend/src/hooks/useVoiceSession.ts): `voice-live-universal-assistant/frontend/src/hooks/useVoiceSession.ts`

### Full-stack Applications

- [Customer Service Bot](https://github.com/microsoft-foundry/voicelive-samples/blob/main/csharp/CustomerServiceBot/CustomerServiceBot.cs): `csharp/CustomerServiceBot/CustomerServiceBot.cs`
- [Customer Functions](https://github.com/microsoft-foundry/voicelive-samples/blob/main/csharp/CustomerServiceBot/CustomerServiceFunctions.cs): `csharp/CustomerServiceBot/CustomerServiceFunctions.cs`
- [Audio Processor](https://github.com/microsoft-foundry/voicelive-samples/blob/main/csharp/CustomerServiceBot/AudioProcessor.cs): `csharp/CustomerServiceBot/AudioProcessor.cs`
- [Car Assistant](https://github.com/microsoft-foundry/voicelive-samples/blob/main/javascript/voice-live-car-demo/src/App.jsx): `javascript/voice-live-car-demo/src/App.jsx`
- [Car Tools](https://github.com/microsoft-foundry/voicelive-samples/blob/main/javascript/voice-live-car-demo/src/tools/carTools.js): `javascript/voice-live-car-demo/src/tools/carTools.js`
- [Voice RAG Assistant](https://github.com/microsoft-foundry/voicelive-samples/blob/main/python/voice-live-voicerag-assistant/app/backend/app.py): `python/voice-live-voicerag-assistant/app/backend/app.py`
- [Avatar Application](https://github.com/microsoft-foundry/voicelive-samples/blob/main/python/voice-live-avatar/app.py): `python/voice-live-avatar/app.py`
- [Trading Assistant](https://github.com/microsoft-foundry/voicelive-samples/blob/main/javascript/voice-live-trader-demo/src/lib/traderAgent.ts): `javascript/voice-live-trader-demo/src/lib/traderAgent.ts`

### Service Integrations

- [RAG Web Handler](https://github.com/microsoft-foundry/voicelive-samples/blob/main/python/voice-live-voicerag-assistant/app/backend/web_handler.py): `python/voice-live-voicerag-assistant/app/backend/web_handler.py`
- [RAG Tool Loader](https://github.com/microsoft-foundry/voicelive-samples/blob/main/python/voice-live-voicerag-assistant/app/backend/tool_loader.py): `python/voice-live-voicerag-assistant/app/backend/tool_loader.py`
- [Avatar Voice Handler](https://github.com/microsoft-foundry/voicelive-samples/blob/main/python/voice-live-avatar/voice_handler.py): `python/voice-live-avatar/voice_handler.py`
- [Python WebSocket Backend](https://github.com/microsoft-foundry/voicelive-samples/blob/main/voice-live-universal-assistant/python/app.py): `voice-live-universal-assistant/python/app.py`
- [C# WebSocket Backend](https://github.com/microsoft-foundry/voicelive-samples/blob/main/voice-live-universal-assistant/csharp/Program.cs): `voice-live-universal-assistant/csharp/Program.cs`
- [JavaScript Backend](https://github.com/microsoft-foundry/voicelive-samples/blob/main/voice-live-universal-assistant/javascript/app.js): `voice-live-universal-assistant/javascript/app.js`

### Guided Development

- [Avatar Integration Skill](https://github.com/microsoft-foundry/voicelive-samples/tree/main/skills/azure-avatar-integrate): `skills/azure-avatar-integrate`

### Other components

- **Sample User**
- **Azure Voice Live**
- **AI Foundry Agents**
- **Azure AI Search**

## Connections

- Sample User → C# Quickstarts: chooses and runs
- Sample User → Python Quickstarts: chooses and runs
- Sample User → JavaScript Quickstarts: chooses and runs
- Sample User → Java Quickstarts: chooses and runs
- C# Quickstarts → Azure Voice Live: integrates with
- Python Quickstarts → Azure Voice Live: integrates with
- JavaScript Quickstarts → Azure Voice Live: integrates with
- Java Quickstarts → Azure Voice Live: integrates with
- C# Quickstarts → AI Foundry Agents: connects agents
- Python Quickstarts → AI Foundry Agents: connects agents
- JavaScript Quickstarts → AI Foundry Agents: connects agents
- Java Quickstarts → AI Foundry Agents: connects agents
- Customer Service Bot → Customer Functions: uses functions (evidence: `csharp/CustomerServiceBot/Program.cs`)
- Customer Service Bot → Audio Processor: uses audio (evidence: `csharp/CustomerServiceBot/CustomerServiceBot.cs`)
- Web Voice Assistant → Azure Voice Live: streams voice
- Education Coach → Azure Voice Live: assesses speech
- Reference AEC → Azure Voice Live: streams reference audio
- Live Interpreter → Azure Voice Live: translates speech
- Car Assistant → Car Tools: executes tools (evidence: `javascript/voice-live-car-demo/src/App.jsx`)
- Car Assistant → Azure Voice Live: connects voice
- Voice RAG Assistant → RAG Web Handler: routes sessions (evidence: `python/voice-live-voicerag-assistant/app/backend/app.py`)
- Voice RAG Assistant → RAG Tool Loader: loads tools (evidence: `python/voice-live-voicerag-assistant/app/backend/app.py`)
- RAG Frontend → Voice RAG Assistant: uses backend
- Voice RAG Assistant → Azure AI Search: retrieves knowledge
- Avatar Application → Avatar Voice Handler: creates handler (evidence: `python/voice-live-avatar/app.py`)
- Avatar Voice Handler → Azure Voice Live: manages sessions (evidence: `python/voice-live-avatar/voice_handler.py`)
- Universal Assistant UI → Voice Session Hook: uses session hook (evidence: `voice-live-universal-assistant/frontend/src/App.tsx`)
- Voice Session Hook → Python WebSocket Backend: connects backend
- Voice Session Hook → C# WebSocket Backend: connects backend
- Voice Session Hook → JavaScript Backend: connects backend
- Python WebSocket Backend → Azure Voice Live: proxies sessions
- C# WebSocket Backend → Azure Voice Live: proxies sessions
- JavaScript Backend → Azure Voice Live: proxies sessions
- Trading Assistant → Azure Voice Live: supports trading voice
- Sample User → Avatar Integration Skill: uses guidance
