# Rivet Voice Assistant - Quick Start

## TL;DR
✅ Built and running on port 8765
🔧 Needs: Twilio webhook configuration
📱 Phone: +61238205443

## Check Status
```bash
systemctl status rivet-voice
```

## Make a Test Call
```bash
cd /home/ccuser/rateright-growth/voice-assistant
source venv/bin/activate
python make_call.py +61426246472
```

## View Logs
```bash
journalctl -u rivet-voice -f
```

## Configure Twilio Webhook

**URL to use:** `ws://134.199.153.159:8765/media-stream`

**TwiML:**
```xml
<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Say voice="alice">Connecting to Rivet</Say>
    <Connect>
        <Stream url="ws://134.199.153.159:8765/media-stream"/>
    </Connect>
</Response>
```

**Where:** https://console.twilio.com/us1/develop/voice/manage/twiml-bins

## Directory Structure
```
/home/ccuser/rateright-growth/voice-assistant/
├── voice_assistant.py      # Main server
├── make_call.py           # Outbound calls
├── .env                   # Credentials (secure)
├── rivet-voice.service    # Systemd config
├── venv/                  # Python environment
├── logs/                  # Daily logs
├── README.md              # Full docs
├── DEPLOYMENT.md          # Production guide
├── BUILD-SUMMARY.md       # Build report
└── QUICK-START.md         # This file
```

## Key Commands

| Action | Command |
|--------|---------|
| Start | `sudo systemctl start rivet-voice` |
| Stop | `sudo systemctl stop rivet-voice` |
| Restart | `sudo systemctl restart rivet-voice` |
| Status | `sudo systemctl status rivet-voice` |
| Logs | `sudo journalctl -u rivet-voice -f` |
| Test Call | `python make_call.py +61426246472` |

## Credentials

All in `.env` file (not in git):
- Anthropic (Claude)
- ElevenLabs (voice)
- Deepgram (STT)
- Twilio (phone)
- OpenAI (backup)

## Troubleshooting

**Service won't start?**
```bash
journalctl -u rivet-voice -n 50
```

**Port in use?**
```bash
lsof -i :8765
kill <PID>
systemctl restart rivet-voice
```

**Call not connecting?**
1. Check service is running
2. Check Twilio webhook is configured
3. Check port 8765 is open
4. Check logs for errors

## Next Steps
1. Configure Twilio webhook (above)
2. Test outbound call
3. Test inbound call by calling +61238205443
4. Monitor logs during test

---
**Built:** 2026-02-04
**Status:** Running ✅
**Docs:** See README.md for full documentation