ochyai/vibe-local

解決的問題

vibe-local 為 Mac 與 Linux 使用者提供完全免費、離線運作的 AI 程式設計環境。無需付費 API 訂閱或持續的網路連線，讓學生、初學者以及在離線工作坊等網路受限環境中的人也能輕鬆使用 AI 輔助程式設計。

工作原理

此專案作為啟動器與設定層，整合三大主要元件：Ollama（用於執行本地 LLM）、TUI（主要使用 OpenCode 引擎），以及一組優化後的本地模型（如 Qwen 和 gpt-oss）。

關鍵技術特性包括：

• 自動模型選擇：偵測系統記憶體，自動建立 Ollama 模型別名（如 vibe-coder 或 vibe-fast），並設定合適的上下文視窗大小（num_ctx），防止記憶體崩潰。
• 智能路由：vibe-router 可將任務拆分，小模型用於快速對話，大模型用於複雜程式碼編寫。
• 彈性 UI 選項：使用者可選擇 OpenCode TUI、Claude Code CLI 相容模式，或內建的 Python 引擎（vibe-coder.py）。
• 本地 RAG：內建的 Python 引擎支援使用 sqlite3 與 Ollama 嵌入的本地檢索增強生成（RAG），將程式碼庫上下文注入提示中。

適用對象

• 學生與教育者：專為非營利研究與教育設計，特別適合沒有付費 AI 方案的使用者。
• 初學者：希望透過自然語言學習終端操作的人。
• 重視隱私的開發者：希望使用本地優先、零成本程式代理的使用者。

亮點

• 零成本且離線運作：完全在使用者硬體上運作，無需網路連線。
• 教室模式：教師可在一台 Mac 上運行模型伺服器，學生透過區域網路連接使用。
• RAM 智能配置：根據可用系統記憶體自動優化模型選擇與上下文長度。
• 多引擎支援：支援多種 TUI 界面與獨立的 Python 引擎，對不支援原生工具呼叫的模型提供 XML 工具呼叫回退。
• 混合連線模式：--auto 模式可在上線時自動切換至雲端版 Claude Code，離線時自動切換至本地 LLM。