# Home Voice Agent

Main mono-repo for the Atlas voice agent system.

## 🚀 Quick Start

**Get started in 5 minutes**: See [QUICK_START.md](QUICK_START.md)

**Test the system**: Run `./test_all.sh` or `./run_tests.sh`

**Configure environment**: See [ENV_CONFIG.md](ENV_CONFIG.md)

**Testing guide**: See [TESTING.md](TESTING.md)

**Test coverage**: See [TEST_COVERAGE.md](TEST_COVERAGE.md)

**Improvements & next steps**: See [IMPROVEMENTS_AND_NEXT_STEPS.md](IMPROVEMENTS_AND_NEXT_STEPS.md)

## Project Structure

```
home-voice-agent/
├── llm-servers/          # LLM inference servers
│   ├── 4080/             # Work agent (Llama 3.1 70B Q4)
│   └── 1050/             # Family agent (Phi-3 Mini 3.8B Q4)
├── mcp-server/           # MCP tool server (JSON-RPC 2.0)
├── wake-word/            # Wake-word detection node
├── asr/                  # ASR service (faster-whisper)
├── tts/                  # TTS service
├── clients/              # Front-end applications
│   ├── phone/            # Phone PWA
│   └── web-dashboard/    # Web dashboard
├── routing/              # LLM routing layer
├── conversation/         # Conversation management
├── memory/               # Long-term memory
├── safety/               # Safety and boundary enforcement
├── admin/                # Admin tools
└── infrastructure/       # Deployment scripts, Dockerfiles
```

## Quick Start

### 1. MCP Server

```bash
cd mcp-server
pip install -r requirements.txt
python server/mcp_server.py
# Server runs on http://localhost:8000
```

### 2. LLM Servers

**4080 Server (Work Agent):**
```bash
cd llm-servers/4080
./setup.sh
ollama serve
```

**1050 Server (Family Agent):**
```bash
cd llm-servers/1050
./setup.sh
ollama serve --host 0.0.0.0
```

## Status

- ✅ MCP Server: Implemented (TICKET-029)
- 🔄 LLM Servers: Setup scripts ready (TICKET-021, TICKET-022)
- ⏳ Voice I/O: Pending (TICKET-006, TICKET-010, TICKET-014)
- ⏳ Clients: Pending (TICKET-039, TICKET-040)

## Documentation

See parent `atlas/` repo for:
- Architecture documentation
- Technology evaluations
- Implementation guides
- Ticket tracking