Python 製ツールを使うための環境構築手順です。Python のインストールと、パッケージマネージャ uv のセットアップを行います。
pyproject.toml や uv.lock ファイルがあるプロジェクトすべてが対象です。主なツール:
| ツール | シリーズ | 説明 |
|---|---|---|
| gem-rag | util-series | RAG検索 |
| ai-ir2 | cybersecurity-series | インシデント対応分析 |
| ir-tracker | cybersecurity-series | ライブIR追跡 |
| ioc-collector | cybersecurity-series | IoC収集 |
| mail-triage | cybersecurity-series | メールトリアージ |
| news-collector | cybersecurity-series | ニュース収集 |
| product-research | cybersecurity-series | 製品リスク調査 |
| cti-primer | cybersecurity-series | CTI PIR生成 |
| meeting-note | lab-series | 議事録構造化 |
| magi-system | lab-series | マルチペルソナ議論 |
| magi-system2 | lab-series | マルチAI議論 |
| sai | lab-series | Slack AIボット |
| virtual-reviewer | lab-series | AIセキュリティレビュー |
| confl-cli | cli-series | Confluence CLIクライアント |
- Windows 10/11 または macOS
- インターネット接続
- ディスク空き容量: 約 500MB（Python + uv + パッケージキャッシュ）
Windows:
- python.org にアクセス
- 最新の Python 3.12 以降をダウンロード
- インストーラを実行
- 重要: インストール画面の一番下にある「Add python.exe to PATH」にチェックを入れてください
- 「Install Now」をクリック
PATH にチェックを入れ忘れた場合、PowerShell から
pythonコマンドが使えません。その場合はインストーラを再実行し、「Modify」→「Add to PATH」を選択してください。
macOS:
brew install python@3.12インストール確認:
PowerShell（Windows）または Terminal（macOS）を新しく開いて:
python --version
Python 3.12.x
Windows で
pythonが見つからない場合はpython3 --versionを試してください。
uv は Python のパッケージマネージャです。pip より高速で、プロジェクトごとの依存関係を自動管理します。
Windows（PowerShell）:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"実行ポリシーの警告が出た場合は「はい」を選択してください。
macOS（Terminal）:
brew install uvインストール確認:
PowerShell / Terminal を新しく開いて:
uv --version
uv 0.x.x
使いたいツールのディレクトリに移動し、uv で依存関係をインストールします。
Windows（PowerShell）:
cd C:\path\to\tool-directory
uv syncmacOS（Terminal）:
cd /path/to/tool-directory
uv syncuv sync は pyproject.toml と uv.lock を読み取り、必要なパッケージをすべて自動でインストールします。
期待される出力:
Resolved XX packages in X.XXs
Installed XX packages in X.XXs
uv でインストールしたツールは uv run で実行します。
uv run python main.py --help
または、ツールにスクリプトが定義されている場合:
uv run <ツール名> --help
具体的なコマンドは各ツールの README を参照してください。
Python と uv が正しくセットアップされているか確認:
python --version
uv --version
両方ともバージョンが表示されれば OK です。
- Python インストール時に「Add to PATH」をチェックし忘れた可能性があります
- Windows: インストーラを再実行 →「Modify」→ PATH を有効化
- PowerShell / Terminal を再起動してください
- uv インストール後に PowerShell / Terminal を再起動してください
- Windows の場合、PATH に
%USERPROFILE%\.local\binが追加されているか確認:$env:PATH -split ";" | Select-String "\.local\\bin"
- uv がシステムの Python を見つけられていません
uv python install 3.12を実行すると、uv が自動で Python をダウンロードします
- ツールが要求する Python バージョンがインストール済みのものと異なる場合があります
uv python install 3.12で必要なバージョンをインストールしてください
- PowerShell の文字コードを UTF-8 に設定:
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
セットアップが完了したら、使いたいツールの README に従って実行してください。
- Vertex AI を使うツールの場合: Vertex AI セットアップ も必要です
- ローカルLLM を使うツールの場合: ローカルLLM セットアップ も必要です