ochyai/vibe-local

何を解決するか

vibe-local は Mac および Linux ユーザー向けに完全に無料でオフラインで動作する AI コーディング環境を提供します。有料 API サブスクリプションや常時接続が必要なインターネット環境を必要としないため、学生や初心者、オフラインワークショップなどネットワーク制限のある環境でも AI ベースのプログラミングを手軽に利用できます。

動作方法

このプロジェクトは、Ollama（ローカル LLM の実行用）、TUI（主に OpenCode エンジンを使用）、および最適化されたローカルモデル（Qwen や gpt-oss など）の3つの主要コンポーネントを統合するランチャーおよび設定レイヤーとして機能します。

主な技術的特徴：

• 自動モデル選択：システムの RAM を検出し、適切なコンテキストウィンドウサイズ（num_ctx）を持つ Ollama モデルエイリアス（例：vibe-coder や vibe-fast）を自動生成してメモリクラッシュを防ぎます。
• インテリジェントルーティング：vibe-router により、小規模モデルで高速チャットを処理し、大規模モデルで複雑なコーディングタスクを実行するようにタスクを分割できます。
• 柔軟な UI オプション：OpenCode TUI、Claude Code CLI との互換モード、または組み込みの Python エンジン（vibe-coder.py）から選択可能です。
• ローカル RAG：組み込みの Python エンジンは sqlite3 と Ollama の埋め込みを用いてローカルな Retrieval-Augmented Generation をサポートし、コードベースのコンテキストをプロンプトに組み込みます。

対象ユーザー

• 学生および教育者：非営利研究および教育を目的として設計されており、有料 AI プランを持たないユーザーに特化しています。
• 初心者：自然言語でターミナル操作を学びたい人。
• プライバシーを重視する開発者：ローカル優先でコストゼロのコーディングエージェントを求める人。

特徴

• ゼロコスト・オフライン：ネットワーク接続なしでユーザーのハードウェア上で完全に動作します。
• 教室モード：教師が1台の Mac でモデルサーバーを起動し、学生が LAN で接続して利用できるようにします。
• RAM 対応設定：利用可能なシステムメモリに基づいてモデル選択とコンテキスト長を自動最適化します。
• マルチエンジン対応：複数の TUI インターフェースと、ツールコール機能が不足するモデル向けに XML ツールコールフォールバックを備えたスタンドアロン Python エンジンをサポートします。
• ハイブリッド接続：--auto モードにより、オンライン時はクラウドベースの Claude Code、オフライン時はローカル LLM に自動切り替えます。