Venv-manager：人間とAIエージェントのためのPython仮想環境ランタイム

Venv-manager は、Go 言語で書かれた革新的な Python 仮想環境管理ツールです。単一の静的バイナリにコンパイルされ、実行時にはシステムに Python 3 がインストールされていれば動作し、uv が利用可能な場合はそれを使って高速化できます。このツールは、人間の開発者と AI エージェント（大規模言語モデルなど）の両方が遭遇する仮想環境管理の課題を解決するために設計されました。

人間のユーザー向けには、venv-manager は明確なコマンドラインインターフェースを提供し、仮想環境の作成、一覧表示、削除、クローン、およびパッケージのインストール、アップグレード、クリーンアップなどの一般的な操作をサポートします。さらに、config init コマンドによる設定の初期化や、Bubble Tea ベースのターミナルユーザーインターフェース（TUI）による環境のブラウズも可能です。特筆すべき機能は「ファイルウォッチャー」モードです。watch app.py --venv myenv と実行すると、指定されたファイルの変更を監視し、軽量な AST パーサーで import 文をスキャンしてサードパーティライブラリを特定します（例：cv2 → opencv-python）。そして、現在の仮想環境にインストールされているパッケージと比較し、不足しているものを自動的に pip インストールします。これにより、仮想環境は常にスクリプトの要件を満たすようになり、LLM による反復的な開発に最適です。

AI エージェント向けには、venv-manager は Model Context Protocol（MCP）サーバーを標準入出力上で提供し、JSON-RPC 2.0 インターフェースを公開します。エージェントは、list_venvs、create_venv、describe_venv、install_packages、run_in_venv、exec_ephemeral などのツールを呼び出すことができます。exec_ephemeral は、一時的な仮想環境を作成し、パッケージをインストールし、コマンドを実行した後、自動的に破棄する機能を一つの呼び出しで提供します。さらに、サンドボックス実行もサポートしており（macOS では sandbox-exec、Linux では bubblewrap を使用）、デフォルトでネットワークを遮断し、一時ディレクトリと仮想環境への書き込みのみを許可するため、信頼できないスクリプトの実行に適しています。

もう一つの主要機能は JSON スナップショットです。describe コマンドは、仮想環境の完全なスナップショット（Python バージョン、パッケージリスト、ディスク使用量、フリーズハッシュ、各シェルのアクティベーションコマンドを含む）を返します。フリーズハッシュにより、エージェントは O(1) で環境のドリフトを検出できます。スナップショットにはラベルを付けて保存でき、ロールバックに使用できます。

設定は ~/.config/venv-manager/config.json に保存され（XDG 環境変数に対応）、ベースディレクトリ、デフォルトの Python バージョン、uv の使用有無などを指定できます。uv がインストールされていて設定が有効な場合、仮想環境の作成が 10～100 倍高速化されます。

Venv-manager のコード構造は明確で、cobra CLI、コア操作マネージャー、MCP サーバー、TUI などの内部パッケージで構成されています。このプロジェクトは GitHub 上で MIT ライセンスのもと公開されており、Jacopo Bonomi が開発しています。現在 35 スターを獲得し、7 つのリリースが行われています。