Overview
Getting Started¶
Welcome to ARTVoice Accelerator
Build real-time voice agents on Azure—from your first deployment to production.
Choose Your Path¶
flowchart TD
START([New to the project?]) --> Q1{Have Azure resources?}
Q1 -->|No| QUICK[📦 Quickstart
Deploy everything with azd up] Q1 -->|Yes| LOCAL[💻 Local Development
Run backend/frontend locally] QUICK --> DEMO[🎮 Demo Guide
Try the voice agent] LOCAL --> DEMO DEMO --> NEXT{What's next?} NEXT --> ARCH[📐 Architecture
Understand the system] NEXT --> CUSTOM[🔧 Customize
Build your own agents] style START fill:#e8f5e9 style QUICK fill:#e3f2fd style LOCAL fill:#fff3e0 style DEMO fill:#f3e5f5
Deploy everything with azd up] Q1 -->|Yes| LOCAL[💻 Local Development
Run backend/frontend locally] QUICK --> DEMO[🎮 Demo Guide
Try the voice agent] LOCAL --> DEMO DEMO --> NEXT{What's next?} NEXT --> ARCH[📐 Architecture
Understand the system] NEXT --> CUSTOM[🔧 Customize
Build your own agents] style START fill:#e8f5e9 style QUICK fill:#e3f2fd style LOCAL fill:#fff3e0 style DEMO fill:#f3e5f5
Step-by-Step Guides¶
| Step | Guide | Time | Description |
|---|---|---|---|
| 0️⃣ | Prerequisites | 5 min | Install required tools (one-time setup) |
| 1️⃣ | Quickstart | 15 min | Deploy to Azure with azd up |
| 2️⃣ | Local Development | 10 min | Run backend/frontend on your machine |
| 3️⃣ | Demo Guide | 10 min | Create profiles, test agents, explore features |
Quick Answers¶
How long does deployment take?
~15 minutes for complete infrastructure + application deployment via azd up.
Do I need a phone number?
No — browser-based voice works without a phone number.
Phone numbers are only needed for PSTN (telephone) integration. See Phone Number Setup.
What Azure resources are created?
| Category | Services |
|---|---|
| AI | Azure OpenAI, Speech Services, VoiceLive |
| Communication | Azure Communication Services |
| Data | Cosmos DB, Redis, Blob Storage |
| Compute | Container Apps, App Configuration |
| Monitoring | Application Insights, Log Analytics |
Which Azure regions are supported?
Most Azure regions with OpenAI availability work. Recommended: East US, West US 2, Sweden Central.
VoiceLive API
Currently in preview with limited regions. Check Speech Services regions.
Can I use existing Azure resources?
Yes! Skip azd up and configure .env manually. See Local Development - Legacy Setup.
Getting Help¶
| Resource | When to Use |
|---|---|
| Troubleshooting | Common issues and solutions |
| GitHub Issues | Bug reports |
| GitHub Discussions | Questions and community help |
Continue Learning¶
After getting started, explore these areas:
| Topic | Guide |
|---|---|
| Understand the architecture | Architecture Overview |
| Customize agents | Agent Framework |
| Production deployment | Deployment Guide |
| Add phone support | Phone Number Setup |