vibe-local

⚡ Ｖ Ｉ Ｂ Ｅ Ｌ Ｏ Ｃ Ａ Ｌ ⚡

    ██╗   ██╗██╗██████╗ ███████╗
    ██║   ██║██║██╔══██╗██╔════╝
    ██║   ██║██║██████╔╝█████╗
    ╚██╗ ██╔╝██║██╔══██╗██╔══╝
     ╚████╔╝ ██║██████╔╝███████╗
      ╚═══╝  ╚═╝╚═════╝ ╚══════╝
              ██╗      ██████╗  ██████╗ █████╗ ██╗
              ██║     ██╔═══██╗██╔════╝██╔══██╗██║
              ██║     ██║   ██║██║     ███████║██║
              ██║     ██║   ██║██║     ██╔══██║██║
              ███████╗╚██████╔╝╚██████╗██║  ██║███████╗
              ╚══════╝ ╚═════╝  ╚═════╝╚═╝  ╚═╝╚══════╝

✨ Free AI Coding Environment — v2 ✨

No network. No cost. Local LLM agent coding.

**** オフラインのワークショップでAIエージェントを使って学習者をサポートしたり、有料プランに未加入の学生がエージェントコーディングを練習したり、ネットワークのない環境で自然言語を使ってターミナル操作を学んだり――そんな場面を想定した、非営利の研究・教育目的のユーティリティツールです。

**** やさしい にほんご：これは、むりょう（おかね いらない）で、AI（えーあい）に プログラムを かいて もらう ための どうぐ です。インターネットが なくても つかえます。がっこう や ワークショップで つかう ために つくりました。

**** Built for offline workshops where instructors support learners with AI agents, for students without paid plans who want to practice agent coding, and for beginners learning terminal operations through natural language — a non-profit research and education utility.

**** 面向离线工作坊中使用AI代理辅助学习者、未订阅付费计划的学生练习代理编程、以及初学者通过自然语言学习终端操作等场景，这是一个非营利性的研究与教育实用工具。

v2.2 (2026-07)

• vibe-auto 自動振り分け — 雑談・短い質問は小型モデルで即答（挨拶 実測30秒→約3秒）、コーディングやツール使用は大型モデルへ。極小パススルールーター (vibe-router) が内容を見て振り分ける。--no-router で無効化可
• thinking暴走の抑制 — 小型モデルがタイトル生成のたびに数十秒「考え込んで」キューを塞ぐ問題を修正（思考オフ注入で 15〜29秒 → 0.2秒）
• プロンプト軽量化 — Claude Code用スキル等の外部取り込みを遮断（システムプロンプト 69KB→30KB ≒ 初回応答が約2倍速）
• vibe専用UI — TUIのロゴ・タイトル等の表示を vibe-local 仕様に調整した専用バイナリ (vibe-tui) を初回起動時に自動生成（エンジンのアップデートに追従して自動再生成）
• 黒灰テーマ vibe-null が新既定 — 零位相の黒と灰。vaporwave (vibe-vaporwave) も --theme vaporwave で選択可
• サクサク化 — 起動と同時にモデルを裏で先読み（最初の応答までの待ちを大幅短縮）、モデル常駐2時間、起動演出の高速化
• --fast — 小型モデルを主役にして軽快に動かすモード

v2 (2026-07)

• TUI を OpenCode エンジンに刷新 — マルチプロバイダをネイティブサポートするMITライセンスのターミナルAIエージェント。Plan/Buildモード、テーマ、LSP連携
• 自作プロキシを廃止 — Ollama が Anthropic Messages API をネイティブ実装 (v0.14+) したため、変換レイヤーが不要に。壊れやすい部品が2000行消滅
• モデルを2026年世代に更新 — qwen3.6 / gpt-oss / qwen3-coder-next / qwen3.5
• コンテキスト長の自動管理 — RAM に応じた num_ctx を焼き込んだ別名モデル vibe-coder / vibe-fast を自動生成（低メモリ機でのメモリ食い潰しを防止）
• 教室モード（実験的） — 先生のMac 1台でモデルを動かし、生徒はattachするだけ
• --classic — 従来どおり Claude Code CLI をUIに使うモードも残存（プロキシなしで直結）

日本語 | やさしい日本語 | English | 中文

これは何？

MacにコマンドをコピペするだけでAIがコードを書いてくれる環境。 ネットワーク不要・完全無料。Ollama + ローカルLLM + OpenCode TUI。

インストール (3ステップ)

1. ターミナルを開く（Spotlight Cmd+Space → "ターミナル"で検索）

2. 以下をコピペしてEnter:

curl -fsSL https://raw.githubusercontent.com/ochyai/vibe-local/main/install.sh | bash

3. 新しいターミナルを開いて起動:

vibe-local

使い方

…

TUIの中では /theme でテーマ変更、Tab で Plan（相談）/ Build（実行）モード切替ができます。

既定のモデル表示は vibe-auto (おまかせ) です。雑談は小型モデルが即答し、 コーディングは大型モデルが引き受けます。特定モデルに固定したい時は TUI内の /models か、vibe-local --no-router を使ってください。

対応環境

トラブルシューティング

よくある問題と解決法

"ollama が起動できませんでした"

open -a Ollama        # macOS
ollama serve          # Linux

"モデルが見つかりません"

ollama pull qwen3.6:35b-a3b     # 自分のRAM帯のモデル名は vibe-local --doctor で確認

"opencode が未インストールです"

brew install opencode

モデルを変更したい

vibe-local --model 
# または ~/.config/vibe-local/v2.conf の BASE_MODEL を編集して
vibe-local --rebuild

テーマを変えたい — vibe-local --theme vaporwave（黒灰に戻すなら --theme null）、または TUI内で /theme

やさしい にほんご

これは なに？

Mac（まっく）で、AI（えーあい）が コードを かいて くれる どうぐ です。 インターネットが なくても つかえます。おかねも かかりません。

いれかた（3つの ステップ）

1. ターミナルを ひらく（Cmd+Space → 「ターミナル」で けんさく）

2. したの もじを コピーして、はりつけて、Enterを おす：

curl -fsSL https://raw.githubusercontent.com/ochyai/vibe-local/main/install.sh | bash

3. あたらしい ターミナルを ひらいて、これを うつ：

vibe-local

つかいかた

# AIと はなしながら プログラムを つくる
vibe-local

# 1かいだけ しつもんする
vibe-local -p "Pythonで じゃんけんゲームを つくって"

きをつけること

⚠️ だいじ：AIが あぶない コマンドを うつことが あります！

AIは かんぺきでは ありません。まちがった コマンドを うつことが あります。

ふつうに つかうと、AIは なにかを する まえに 「これを やっていい？」と きいてきます。 わからない ときは 「いいえ」を えらんで ください。

きけんな サイン — こんな コマンドは ゆるさないで！

あんぜんに つかう ほうほう：

• AIが コマンドを うつまえに、「これを やっていい？」と きいてきます
• わからない コマンドは ぜったいに ゆるさないで ください
• だいじな ファイルが ある フォルダでは つかわないで ください
• こまったら、Ctrl+C で とめられます

English

What is this?

A free AI coding environment you can set up with a single command on your Mac. No network required. Completely free. Ollama + local LLM + the OpenCode TUI.

Install (3 steps)

1. Open Terminal (Spotlight Cmd+Space → search "Terminal")

2. Paste and hit Enter:

curl -fsSL https://raw.githubusercontent.com/ochyai/vibe-local/main/install.sh | bash

3. Open a new terminal and run:

vibe-local

Usage

…

Inside the TUI: /theme switches themes, Tab toggles Plan / Build mode.

Supported Environments

Troubleshooting

Common issues and solutions

"ollama failed to start"

open -a Ollama        # macOS
ollama serve          # Linux

"model not found"

ollama pull qwen3.6:35b-a3b     # check your RAM tier's model with: vibe-local --doctor

"opencode not installed"

brew install opencode

Change model

vibe-local --model 
# or edit BASE_MODEL in ~/.config/vibe-local/v2.conf, then
vibe-local --rebuild

中文

这是什么？

在Mac上只需复制粘贴一个命令，AI就能帮你写代码。 无需网络，完全免费。Ollama + 本地大语言模型 + OpenCode 终端界面。

安装（3步）

1. 打开终端（Spotlight Cmd+Space → 搜索"终端"或"Terminal"）

2. 粘贴以下命令并按回车：

curl -fsSL https://raw.githubusercontent.com/ochyai/vibe-local/main/install.sh | bash

3. 打开新终端并运行：

vibe-local

使用方法

# 交互模式（与AI对话编程）
vibe-local

# 单次执行（只问一次）
vibe-local -p "用Python写一个贪吃蛇游戏"

# 自动检测网络（有网用Claude Code，没网用本地）
vibe-local --auto

# 快速模式（用小模型作为主力）
vibe-local --fast

# 手动指定模型
vibe-local --model devstral

# 切换主题（null = 黑灰色，默认 / vaporwave）
vibe-local --theme vaporwave

# 兼容模式（用 Claude Code CLI 作为界面）
vibe-local --classic

# 教室模式：老师启动服务器，学生连接
vibe-local --serve
vibe-local --attach http://192.168.x.x:4096

# 环境诊断
vibe-local --doctor

在TUI中：/theme 切换主题，Tab 切换 Plan / Build 模式。

支持的环境

故障排除

常见问题及解决方法

"ollama 无法启动"

open -a Ollama        # macOS
ollama serve          # Linux

"未找到模型"

ollama pull qwen3.6:35b-a3b     # 用 vibe-local --doctor 查看你的内存档位对应的模型

"opencode 未安装"

brew install opencode

更换模型

vibe-local --model 
# 或编辑 ~/.config/vibe-local/v2.conf 的 BASE_MODEL 后执行
vibe-local --rebuild

Architecture (v2)

User
  ↓
vibe-local (launcher)
  ├─ RAM検出 → モデル選択 → num_ctx焼き込み別名 (vibe-coder / vibe-fast) を ollama create
  ├─ OpenCode設定生成 (OPENCODE_CONFIG, ユーザーの素のOpenCode設定は汚さない)
  │
  ├─ 既定:        OpenCode TUI ──(OpenAI互換 /v1)──→ Ollama → ローカルLLM
  ├─ --classic:    Claude Code CLI ──(ネイティブ /v1/messages)──→ Ollama → ローカルLLM
  ├─ --vibe-coder: 内蔵Pythonエンジン vibe-coder.py ──(/api/chat)──→ Ollama → ローカルLLM
  ├─ --serve:      OpenCode server を LAN公開 (教室モード, 生徒は --attach)
  └─ --auto:       オンライン→Claude Code(クラウド) / オフライン→ローカル

v1 の自作変換プロキシ (anthropic-ollama-proxy.py) と MLX 直結サーバー (localllm.py) は Ollama のネイティブ Anthropic API 対応 (v0.14+, 2026-01) と MLX バックエンド (v0.19+) により 役目を終え、legacy/ にアーカイブされています。

内蔵Pythonエンジン vibe-coder.py と RAG

コミュニティ製の依存ゼロ (stdlib のみ) コーディングエージェント vibe-coder.py を --vibe-coder（別名 --engine）で起動できます。OpenCode / Node を使わず、 Ollama の /api/chat に直結してツール実行ループを回します。主な機能:

• ローカル RAG（--rag）: sqlite3 + Ollama 埋め込みだけで、コードベースの関連コンテキストを system prompt に注入。索引作成は vibe-local --vibe-coder --rag-index 、 参照は --rag --rag-path .。索引は .vibe/rag/ に保存（git 管理外）。 トップK件数は --rag-topk、埋め込みモデルは --rag-model（既定 nomic-embed-text）で調整。
• ツールコール XML フォールバック: ネイティブ tool_calls が来ない Qwen 系モデルでも、 応答テキスト中の XML 形式のツールコールを抽出して実行（ストリーミング応答でも動作）。
• 堅牢な許可入力: stdin が TTY でない場合も /dev/tty にフォールバック。日本語「はい」/ 英語 yes / 中国語「是」の三言語で承認可能。

vibe-coder.py は単体でも実行できます（python3 vibe-coder.py -p "..."）。 Windows 向けには install.ps1 / vibe-local.ps1（コミュニティ提供）も同梱しています。

Security / セキュリティ / 安全须知

日本語

⚠️ このツールは自己責任でご利用ください。AIが実行するコマンドには注意が必要です。

v2 の既定は 毎回確認モード です。AIがファイル編集・コマンド実行をする前に必ず許可を求めます。 vibe-local -y を付けると ツール自動許可モード になり、AIが確認なしで ファイルの読み書き・コマンド実行・システム操作を行います。

ローカルLLMはクラウドAIより精度が低いため、意図しない危険な操作を実行するリスクがあります。

こんなコマンドに注意

AIが提案するコマンドの中に以下のキーワードが含まれていたら、内容を理解できない限り拒否してください：

安全に使うためのルール

1. 既定の毎回確認モードで使う — AIの各操作を事前に確認できます
2. わからないコマンドは許可しない — 少しでも不安なら拒否
3. 大事なファイルがあるフォルダでは使わない — 新しい空フォルダで練習
4. sudo を求められたら基本的に拒否 — ローカルLLMの判断でシステム操作させない
5. 困ったら Ctrl+C で停止

vibe-local        # 毎回確認モード（推奨・既定）
vibe-local -y     # 自動許可モード（上級者向け・自己責任）

やさしい にほんご

⚠️ だいじな おしらせ：AIは まちがえることが あります！

AIが うごかそうとする コマンド（めいれい）を よく みてください。 わからない コマンドは、ぜったいに ゆるさないで ください。

• ふつうの モードでは、AIが まいかい 「これ やっていい？」と きいてきます
• rm（さくじょ）や sudo（かんりしゃ）が はいった コマンドは きけん
• こまったら Ctrl+C（コントロール と C を いっしょに おす）で とまる
• れんしゅうは あたらしい からの フォルダ で やる

English

⚠️ Use this tool at your own risk. Pay attention to the commands the AI executes.

v2 defaults to ask-before-every-action mode. With vibe-local -y the AI can read/write files, execute commands, and modify your system without asking.

Local LLMs are less accurate than cloud AI — they may attempt dangerous operations unintentionally.

If a suggested command contains sudo, chmod/chown, dd/mkfs//dev/, config-overwriting >, a --force flag, or anything you can't read — reject it.

vibe-local        # Ask mode (recommended, default)
vibe-local -y     # Auto-approve mode (advanced users only, at your own risk)

中文

⚠️ 使用本工具风险自负。请注意AI执行的每一个命令。

v2 默认为每次操作前确认。使用 vibe-local -y 后，AI可以在无需确认的情况下 读写文件、执行命令、修改系统。

本地LLM的精度低于云端AI，可能意外执行危险操作。

如果命令中包含 sudo、chmod/chown、dd/mkfs//dev/、覆盖配置的 >、--force， 或任何你看不懂的内容——务必拒绝。

vibe-local        # 确认模式（推荐，默认）
vibe-local -y     # 自动批准模式（仅限高级用户，风险自负）

⚙️ Notes

• Local LLM accuracy is lower than Claude API
• First model download takes ti