Home

CAAL Wiki

Welcome to the CAAL documentation wiki. CAAL is a local voice assistant built on LiveKit Agents with n8n workflow integrations and Home Assistant control.

Quick Links

Getting Started

• Installation - Get CAAL running in minutes
• First-Start Wizard - Configure STT, LLM, TTS, and integrations

Architecture & Concepts

• CAAL Tool API - The complete tool system: spec, registry, submission pipeline, and install flow
• How Tool Calling Works - How CAAL discovers and executes tools via MCP
• Voice Pipeline - STT → LLM → TTS flow

Tools

• Tool Registry - Browse, install, and submit community tools
• Contributing Guide - Submit your tools

Integrations

• Home Assistant - Smart home voice control
• n8n Setup - Enable MCP and configure workflows

Deployment

• Apple Silicon - Run on M1/M2/M3/M4 Macs
• Distributed Deployment - Split GPU backend and frontend

Key Concepts

Infrastructure Layer

CAAL is not just a voice assistant - it's an infrastructure layer. The voice assistant is the first application.

Infrastructure Layer (CAAL)
├── Voice Pipeline - LiveKit, STT, TTS
├── Routing - Ollama/Groq/OpenRouter/OpenAI-compatible, tool calling
├── Memory - Memento, temporal awareness
└── Integrations - MCP protocol

Application Layer (CAAL Tool API)
├── Smart home control
├── Personal productivity
├── Media management
└── Whatever you build

CAAL Tool API

The CAAL Tool API defines how tools are built, shared, and installed:

• Tool Spec - Webhook + notes + MCP. Tool suites (Switch-based multi-action) or individual tools.
• Registry - Community tools at github.com/CoreWorxLab/caal-tools
• Submission Pipeline - Client-side sanitization → VPS metadata generation → GitHub PR → automated review
• Install Flow - Browse in CAAL UI → configure variables/credentials → one-click install

Tool Acquisition Hierarchy

1. Check existing tools - "I can already do that"
2. Check registry - "Found one, want me to install it?"
3. Adapt from registry - "Found something close, let me tweak it"
4. Build from scratch - "Nothing exists, I'll create one"

Support

• GitHub Issues - Report bugs or request features
• Discussions - Ask questions, share setups
• Discord - Join the community (coming soon)

Video Guides

• P010: CAAL Public Launch - Introduction and demo
• P012: Android App - Mobile client setup
• P013: The Ultimate Homelab Voice Assistant - No-GPU setup with Groq

Project Links

• Main Repository - github.com/CoreWorxLab/caal
• Tool Registry - github.com/CoreWorxLab/caal-tools
• Registry Website - registry.caal.io