CAAL
  
您实际拥有的自托管语音助手。通过设计确保安全-LLM永远不会看到您的API密钥。
CAAL是一个基于 LiveKit代理 它完全在你的硬件上运行。你的声音、数据、凭证——都在你的网络上。
______________________________________________________________________
为什么选择CAAL？
专门构建的模型。 CAAL船舶 caal-ministral --专门为语音工具调用训练的微调8B模型。它知道如何控制你的智能家居，将工具连接在一起，并自然地做出反应。LLM是架构的一部分，而不是架构。它处理代码无法处理的决策——调用哪个工具、使用什么参数、何时链接步骤。其他一切都是代码。这就是为什么8B型号有效。
ollama pull coreworxlab/caal-qwen3.5-9b默认情况下为本地。 完全在您的网络上运行 奥拉玛。没有帐户，没有遥测，没有云依赖。想要使用 Groq, 开放路由，或任何与OpenAI兼容的API？你的选择。无论如何，您的凭据和工具执行永远不会离开您的网络。
______________________________________________________________________
特性
- 工具注册表 --一键浏览并安装社区工具。每次提交都要经过自动安全审查和人工批准
- 工具链 --在一个提示中连续调用多个工具。该模型使用每一步的真实数据来通知下一步
- 家庭助手 --通过以下方式对灯光、盖子、锁、气候、媒体等进行语音控制
hass - n8n工作流 --任何工作流都会变成一种工具。通过n8n的执行历史进行可视化、可检查、可共享、可审计
- 灵活的供应商 -Ollama、Groq、OpenRouter或任何与OpenAI兼容的API。STT的演讲或演讲。Kokoro或Piper for TTS
- 短期记忆 --跨会话存储和调用信息
- 国际化 --英语、法语、意大利语，还有更多
- 唤醒词 --“嘿，卡尔”通过OpenWakeWord
- 网络搜索 --DuckDuckGo集成实时信息
- 移动应用程序 --Android客户端可从 发布
- Webhook API -用于公告、设置和外部触发器的REST API
______________________________________________________________________
快速开始
git clone https://github.com/CoreWorxLab/caal.git
cd caal
cp .env.example .env
nano .env # Set CAAL_HOST_IP to your server's LAN IP
# If using Ollama (recommended)
ollama pull coreworxlab/caal-ministral:latest
docker compose up -d打开 https://YOUR_SERVER_IP:3443 并完成安装向导。
部署选项
| 模式 | 硬件 | 命令 | 指南 |
|---|---|---|---|
| 图形处理器 | Linux+NVIDIA GPU | docker compose up -d | 以上快速入门 |
| 仅CPU | 任何Docker主机 | docker compose -f docker-compose.cpu.yaml up -d | Wiki:CPU模式 |
| 苹果芯片 | M1/M2/M3/M4 Mac | ./start-apple.sh | 苹果硅指南 |
| 分布式 | GPU服务器+前端 | 请参阅指南 | 分布式指南 |
HTTPS和网络
默认情况下，HTTPS启用自动生成的自签名证书。这是必需的，因为浏览器会阻止非-localhost HTTP。
为了避免浏览器证书警告，请信任自动生成的证书：
./trust-cert.sh这适用于macOS和Linux（Debian/Ubuntu、RHEL/Fedora、Arch、Chrome、Firefox）。通过 --yes 跳过确认提示。在苹果硅上， start-apple.sh 自动运行它。
或者，使用浏览器信任的证书 mkcert:
mkcert -install && mkcert 192.168.1.100
mkdir -p certs && mv 192.168.1.100.pem certs/server.crt && mv 192.168.1.100-key.pem certs/server.key移动应用程序直接通过LiveKit连接，不需要HTTPS。
______________________________________________________________________
文档
| 资源 | 描述 |
|---|---|
| 维基 | 完整的文档——架构、配置、部署 |
| 家庭助手 | 智能家居集成设置和使用 |
| n8n工作流 | 创建和连接工作流工具 |
| 苹果芯片 | 在M1/M2/M3/M4 Mac上运行 |
| 分布式部署 | 拆分GPU后端和前端 |
| 国际化 | 添加语言支持 |
| 工具注册表 | 浏览并提交社区工具 |
| 贡献.md | 开发设置和贡献指南 |
______________________________________________________________________
建筑
https://:3443 https://:7443
│ │
┌─────┴─────────────────────┴─────┐
│ nginx (TLS) │
│ :3443 :7443 │
└─────┬─────────────────┬─────────┘
│ │
┌───────────────────────────────┼─────────────────┼───────────────────┐
│ Docker Compose Stack │ │ │
│ │ │ │
│ ┌────────────┐ ┌─────┴──────┐ ┌───────┴────┐ ┌────────┐ │
│ │ Speaches │ │ Frontend │ │ LiveKit │ │ Kokoro │ │
│ │(STT, GPU) │ │ (Next.js) │ │ Server │ │ (TTS) │ │
│ │ :8000 │ │ :3000 │ │ :7880 │ │ :8880 │ │
│ └─────┬──────┘ └─────┬──────┘ └─────┬──────┘ └───┬────┘ │
│ │ │ │ │ │
│ └──────────────────────┼───────────────┼─────────────┘ │
│ │ │ │
│ ┌─────┴───────────────┴─────┐ │
│ │ Agent │ │
│ │ (Voice Pipeline) │ │
│ │ :8889 (webhooks) │ │
│ └─────────┬─────────────────┘ │
│ │ │
└───────────────────────────────────┼─────────────────────────────────┘
│
┌────────────────────────┼────────────────────────┐
│ │ │
┌─────┴─────┐ ┌──────┴──────┐ ┌──────┴──────┐
│ Ollama │ │ n8n │ │ Home │
│Groq / OR │ │ Workflows │ │ Assistant │
└───────────┘ └─────────────┘ └─────────────┘
External Services (via MCP)______________________________________________________________________
社区
CAAL是露天建造的。如果你构建一个工具，我们会看到PR。如果你发现一个bug，我们会发现问题。
______________________________________________________________________
相关项目
- LiveKit代理 -语音代理框架
- 说话 -更快的Whisper STT+Piper TTS
- Kokoro快速API -Kokoro TTS服务器
- 奥拉玛 -本地LLM服务器
- Groq -快速云LLM推理
- 开放路由 -适用于200多种型号的统一API
- n8n -工作流自动化
- 家庭助手 -智能家居平台
贡献
我们欢迎捐款！看 贡献.md 作为指导方针。
许可证
MIT许可证——见 许可证 了解详情。