Getting Started¶
Work in progress
This guide is being written. The sections below outline what will be covered.
Prerequisites¶
- Docker + Docker Compose
- Java 17+ (for Spring Boot services)
- Python 3.11+ (for AI services: Atlas, Compass, Herald, Call Insights)
- Node.js 20+ (for React frontends)
Service Quick-Start¶
Each service has its own README. Refer to the Architecture Overview for how services connect.
| Service | Runtime | Port |
|---|---|---|
| Call Service | Java / Spring Boot | 8080 |
| Billing Service | Java / Spring Boot | 8081 |
| Tenant Service | Java / Spring Boot | 8082 |
| Reporting Service | Java / Spring Boot | 8083 |
| Compass | Python / FastAPI | 8000 |
| Atlas | Python / LiveKit plugin | — |
| Call Insights | Python / FastAPI | 8084 |
| Nexivo Admin | Node / Vite | 5173 |
| Agent Desktop | Node / Vite | 5174 |
Local Infrastructure¶
The platform depends on:
- PostgreSQL — primary relational store
- Redis — routing tables, caching, billing counters, stream events
- Qdrant — vector store for knowledge base semantic search
- MinIO — object storage for call audio files
- LiveKit — media/session layer
- Keycloak — identity and access management