allgpt-co/QuickVoice

QuickVoice – 開源 AI 電話智能體平台

產品簡介 – 一個可自託管的堆疊，允許工程團隊構建、執行和擴展基於語音的 AI 智能體（入站接待、出站銷售機器人等）。它在一個單體倉庫（monorepo）中集成了行銷網站、客戶控制台、Express API、Python LiveKit 工作進程、電話集成（Twilio/Telnyx）、知識庫（Pinecone）支持、計費（Stripe）以及所有相關的基礎設施（Postgres, Redis, S3 等）。

重要意義 – 大多數語音智能體服務是以封閉的 SaaS API 形式提供的（例如 Retell）。QuickVoice 為您提供具有完全原始碼級控制權的相同產品介面，從而實現隱私審查、成本透明度以及託管服務無法提供的自定義擴展。

核心功能 (詳見 README)

類別	亮點
智能體執行環境	基於 Python 編寫的 LiveKit 語音工作進程；單次通話配置（提示詞、語音、語言、動態變數）；支持 STT (Deepgram, Sarvam)、LLM (AWS Bedrock)、TTS (ElevenLabs, Sarvam)。
知識與工具	用於 RAG 的 Pinecone 向量資料庫；Google embeddings；MCP/Smithery 工具橋接；通話期間調用外部 HTTP 工具的能力（帶有安全防護）。
電話通信	Twilio 和 Telnyx 號碼購買、入站路由、出站通話、批量活動、LiveKit 中繼綁定。
控制台與 API	為組織、智能體、號碼、知識庫、API 密鑰、計費、設置提供的 Next.js 客戶控制台；具有身份驗證、權限、Stripe 集成和 Webhook 處理功能的 Express API。
隱私與合規	預設 PII 去識別化、可選的零 PII 模式、加密的機密資訊、URL 白名單、針對轉錄文本、錄音、知識庫行和工具日誌的自動保留任務。
計費	帶有測試模式錢包流程的 Stripe 集成；支持訂閱式用量和預付額度。
開發體驗	通過單一命令 `task up:dev` (Docker Compose, pnpm, Python venv) 在本地啟動完整堆疊；用於資料庫遷移、數據填充、CI、代碼檢查和測試的廣泛 Taskfile 腳本。
可擴展性	單體倉庫 (pnpm + Turborepo) 使分叉、添加新提供商、修改智能體、插入自定義 MCP 工具或更換語音目錄變得非常容易。

架構概覽

Visitor → task up:dev →
  ├─ apps/web      (行銷網站)
  ├─ apps/console  (客戶 UI)
  ├─ apps/server   (Express API, 身份驗證, 資料庫, Stripe, Twilio/Telnyx)
  └─ apps/ai       (Python LiveKit 工作進程, RAG, 工具執行)
        │
        └─ LiveKit ↔ Telephony (Twilio/Telnyx)

所有服務都在本地通過 Postgres 和 Redis 容器運行；生產環境需要您提供自己的 LiveKit、電話和雲端提供商憑據。

技術棧 (源自 README)

前端: Next.js (React) + Tailwind CSS
API: Express (TypeScript) 配合 Better Auth
語音執行環境: LiveKit Agents, Python 工作進程, Silero VAD, 多語言輪次檢測, 降噪
電話: Twilio, Telnyx
AI 提供商: 通過 LiveKit 推理配置 STT/TTS/LLM (預設: Deepgram, AWS Bedrock, ElevenLabs)
知識與工具: Pinecone 向量資料庫, Google embeddings, MCP/Smithery 橋接, 自定義 HTTP 工具
數據存儲: PostgreSQL (Prisma ORM), Redis/BullMQ, S3 相容物件存儲
計費: Stripe
編排: Docker Compose, Go Task, pnpm (v9), Turborepo
語言執行環境: Node 20/22+, Python 3.12, Go (用於 Task)

項目成熟度

狀態: 開發中，尚未發布穩定版本 (ROADMAP.md 及 v0.1.0 草案說明)。
許可證: MIT (允許商業用途)。
社區: 提供公開的 Issue 提交表單、貢獻指南、治理文件及路線圖。歡迎 Star 和社區關注，但該項目目前尚未達到開箱即用的生產就緒狀態。

典型用例

入站 AI 接待員 – 接聽電話、查詢客戶數據、提供支持。
出站活動 – 自動提醒、銷售電話、催收，並帶有結果追蹤。
預約排程 – 語音驅動的預訂流程。
基於知識的智能體 – 根據上傳的文檔或向量庫知識回答問題。
特定領域自動化 – 醫療分診、金融服務驗證、物流協調、房地產潛在客戶篩選、電子商務支持。

入門指南 (快速摘要)

前提條件 – Linux/macOS (或 Windows 上的 WSL2), Bash ≥ 4, Node 20/22+, pnpm 9, Python 3.12, Docker Compose v2, Go Task。
運行 – task up:dev 創建環境文件，啟動 Postgres 和 Redis，運行遷移並啟動所有服務。
訪問 – 控制台位於 http://localhost:3000，行銷網站位於 http://localhost:3001，API 健康檢查位於 http://localhost:5000/api/v1/health，AI 工作進程健康檢查位於 http://localhost:5555/health。
添加真實憑據 – 在 .env.dev 中填寫 LiveKit, Twilio/Telnyx, AWS, Deepgram, ElevenLabs, Stripe 等資訊，以實現即時通話功能。

總結

QuickVoice 是專有語音智能體平台的全面開源替代方案。它賦予團隊檢查、定制和自託管語音 AI 堆疊每一部分的能力——從 Web 控制台到電話提供商——同時為 RAG、工具執行、計費和隱私控制提供開箱即用的支持。雖然仍處於早期階段，但該倉庫包含完整的單體倉庫、詳細的文檔以及為願意管理自身基礎設施的團隊提供的清晰的生產路徑。