diff --git a/docs-tech/codebuff-local-oneliner/index.md b/docs-tech/codebuff-local-oneliner/index.md index 81979c9..d1a130a 100644 --- a/docs-tech/codebuff-local-oneliner/index.md +++ b/docs-tech/codebuff-local-oneliner/index.md @@ -1,50 +1,51 @@ --- sidebar_position: 2 -title: Codebuffをローカル展開するワンライナー -description: OpenRouter + Codebuffをローカル環境に最短で導入する手順 +title: Codebuffを完全ローカルで動かすワンライナー +description: Ollama導入済み環境でCodebuffを外部SaaSに接続せずローカル実行する最短手順 hide_table_of_contents: false displayed_sidebar: null image: /img/codebuff-local-oneliner-banner.png --- -# Codebuffをローカル展開するワンライナー +# Codebuffを完全ローカルで動かすワンライナー -Codebuffを手元マシンでサクッと使えるようにするための最短手順です。 +「Ollamaは各環境に入っている」前提で、Codebuffを**ローカルLLMだけ**で動かす最短手順です。 ## 前提 - Node.js 18+ -- `OPENROUTER_API_KEY` を取得済み +- Ollama インストール済み(`ollama` コマンドが使える) +- `codebuff` コマンドが使える(未導入なら `npm i -g codebuff`) ## ワンライナー -```bash title="セットアップ一発実行" -export OPENROUTER_API_KEY="sk-or-xxx" && curl -sL https://www.techswan.online/scripts/codebuff-local-setup.sh | bash +```bash title="Ollama導入済み前提・完全ローカル実行" +ollama pull qwen2.5-coder:32b && OPENAI_BASE_URL=http://127.0.0.1:11434/v1 OPENAI_API_KEY=dummy OPENROUTER_API_KEY= NO_TELEMETRY=1 CODEBUFF_DISABLE_UPDATE=1 codebuff --model qwen2.5-coder:32b ``` -特定のプロジェクトディレクトリを指定する場合は以下: +特定のプロジェクトディレクトリで起動する場合は、最後にパスを付けます。 ```bash title="プロジェクト指定" -export OPENROUTER_API_KEY="sk-or-xxx" && curl -sL https://www.techswan.online/scripts/codebuff-local-setup.sh | bash -s -- ~/my-project +ollama pull qwen2.5-coder:32b && OPENAI_BASE_URL=http://127.0.0.1:11434/v1 OPENAI_API_KEY=dummy OPENROUTER_API_KEY= NO_TELEMETRY=1 CODEBUFF_DISABLE_UPDATE=1 codebuff --model qwen2.5-coder:32b ~/my-project ``` ## 何をしているか -1. `npm i -g codebuff` -2. プロジェクトへ移動 -3. `/init` 実行(`knowledge.md` と `.agents` を生成) -4. `codebuff` 起動準備 +1. `ollama pull` でローカルモデルを取得 +2. `OPENAI_BASE_URL=http://127.0.0.1:11434/v1` でAPI向き先をlocalhostに固定 +3. `OPENROUTER_API_KEY=` を空にしてOpenRouter利用を抑止 +4. `NO_TELEMETRY=1` と `CODEBUFF_DISABLE_UPDATE=1` で外向き挙動を最小化 +5. `codebuff --model ...` でローカルモデルを明示して起動 -## 使い方のコツ +## 注意点 -- 初回は「まずプロジェクトの構造を説明して」から始める -- 次に「小さな修正」を頼んで挙動を掴む -- いきなり大改修より、段階的に指示した方が安定 +- **「完全ローカル」要件を厳密に満たすには、OS側のFWで外向き通信制限も推奨**です。 +- まずは短いタスク(小修正・説明依頼)で挙動確認してから本作業へ。 ## 参考リンク - [Codebuff GitHub](https://github.com/CodebuffAI/codebuff) -- [OpenRouter Models](https://openrouter.ai/models) +- [Ollama](https://ollama.com/) --- diff --git a/docs-tech/index.md b/docs-tech/index.md index d024f63..2c66ed5 100644 --- a/docs-tech/index.md +++ b/docs-tech/index.md @@ -23,7 +23,7 @@ slug: / ## その他 - [ローカルサーバーでマイク・カメラを使う方法](/tech/browser-secure-context/) -- [Codebuffをローカル展開するワンライナー](/tech/codebuff-local-oneliner/) +- [Codebuffを完全ローカルで動かすワンライナー](/tech/codebuff-local-oneliner/) - [ゲーム画面をリアルタイム翻訳するAIアプリを作った話](/tech/game-vision-companion/) - [Issue 立てるだけで AI がコードレビュー&修正してくれる仕組みを作った](/tech/gitea-webhook-ai-review/) - [SearXNGでローカル検索APIを構築する](/tech/searxng-local-search/)