LocalCode - ローカルLLM自律コーディングエージェント

特徴

必要環境

インストール

Windows (簡単セットアップ)

setup.bat

手動セットアップ

# 1. 依存パッケージをインストール
pip install -r requirements.txt
# 2. .envファイルを作成
cp .env.example .env
# 3. Ollamaをインストール (未インストールの場合)
# Windowsの場合:
winget install Ollama.Ollama
# または https://ollama.ai/download からダウンロード
# 4. Ollamaを起動
ollama serve
# 5. モデルをダウンロード (推奨: qwen2.5-coder:7b)
ollama pull qwen2.5-coder:7b
# 6. 接続確認
python main.py --check

使い方

単発タスク

# ファイル一覧
python main.py "このディレクトリのPythonファイルを一覧表示して"
# コード作成
python main.py "足し算・引き算・掛け算ができる calculator.py を作って"
# バグ修正
python main.py "このディレクトリのコードを調べてバグがあれば修正して"
# Web検索を使った調査
python main.py "Python asyncioの最新のベストプラクティスを調べてまとめて"

インタラクティブモード

python main.py
# >>> と表示されたらタスクを入力
# 'exit' で終了

オプション

# モデルを指定
python main.py --model qwen2.5-coder:14b "タスク"
# OpenAI互換API (LM Studio等) を使用
python main.py --provider openai_compatible "タスク"
# 確認なしで自動実行 (注意)
python main.py --no-confirm "タスク"
# ツールモードを指定
python main.py --tool-mode xml "タスク" # XMLフォールバック強制
# 環境確認
python main.py --check

推奨モデル

設定 (config.yaml)

llm:
 provider: ollama # "ollama" or "openai_compatible"
 model: qwen2.5-coder:7b # 使用モデル
 tool_mode: auto # "auto" | "native" | "xml"
agent:
 max_iterations: 40 # エージェントループの最大反復回数
 confirm_tools: # 実行前に確認が必要なツール
 - bash
 - write_file
 - edit_file

利用可能なツール

OpenAI互換API (LM Studio等)

OPENAI_API_KEY=not-needed
OPENAI_BASE_URL=http://localhost:1234/v1
LOCAL_MODEL=your-model-name

llm:
 provider: openai_compatible
 openai_base_url: "http://localhost:1234/v1"

トラブルシューティング

# Ollamaが起動しているか確認
ollama serve
# または別ターミナルで確認
curl http://localhost:11434/api/tags

ollama list # インストール済みモデル確認
ollama pull qwen2.5-coder:7b

python main.py --tool-mode xml "タスク"

python main.py --no-confirm "タスク"