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。