Python仮想環境でハマった依存関係エラーの解決方法

Python仮想環境でハマった依存関係エラーの解決方法

こんにちは!今日は入れた覚えの無いパッケージが引き起こす「あるある」な謎エラーと原因について記載します。

今回の環境は Windows に Python,Anaconda を入れた状態で発生した例ですが、Linuxでも本質的には同じだとおもいます。

グローバル環境の汚染が原因だった話

問題の発生

Pythonプロジェクトの環境構築中、必要なパッケージをインストールしていたら、突然エラーメッセージが表示されました。

pip install opencv-python==4.8.1.78

実行後に表示されたエラー

ERROR: pip's dependency resolver does not currently take into account all the packages that are installed. 
This behaviour is the source of the following dependency conflicts.
accelerate 0.19.0 requires packaging>=20.0, which is not installed.
accelerate 0.19.0 requires psutil, which is not installed.
accelerate 0.19.0 requires torch>=1.6.0, which is not installed.

最初の疑問

「accelerateなんてインストールしてないのに...」

今回インストールしようとしていたのは、Webアプリケーション開発用のパッケージ群で、機械学習系のaccelerateは含まれていませんでした。

どこからaccelerateが出てきたのか?

原因の調査

まず、accelerateの場所を確認:

pip show accelerate

結果

Name: accelerate
Version: 0.19.0
Location: c:\users\[username]\appdata\roaming\python\python310\site-packages
Required-by: 

ポイント

  • Locationが仮想環境(c:\tools\anaconda3\envs\...)ではない
  • ユーザーのグローバル環境(appdata\roaming)にインストールされている
  • Required-byが空 = 誰も依存していない

真相

ユーザー環境の全パッケージを確認

pip list --user

結果、20個以上のパッケージがグローバルに入っていることが判明。様々なプロジェクトで使われるパッケージが混在している状態でした。

原因:過去に誰か(たぶん自分💦)が仮想環境を有効化せずにパッケージをインストールしていた

よくある失敗パターン

パターン1: 仮想環境の有効化を忘れる

# 間違い:仮想環境を有効化し忘れ
pip install some-package

# 正解:仮想環境を有効化してからインストール
conda activate myenv
pip install some-package

パターン2: --userオプションの誤用

# 間違い:グローバルにインストール
pip install --user some-package

# 正解:仮想環境内にインストール
pip install some-package

パターン3: IDEの環境設定ミス

VSCodeやPyCharmで間違った環境を選択していると、意図しない場所にパッケージがインストールされる

解決方法

方法1: 問題のパッケージだけ削除

pip uninstall -y accelerate

方法2: ユーザー環境を完全クリーンアップ(これが推奨)

PowerShellで実行

pip list --user --format=freeze | ForEach-Object { $_.split('==')[0] } | ForEach-Object { pip uninstall -y $_ }

コマンドプロンプトの場合

for /f "delims==" %i in ('pip list --user --format=freeze') do pip uninstall -y %i

教訓とベストプラクティス

1. 常に仮想環境を使う

# Anaconda
conda create -n myproject python=3.10
conda activate myproject

# または venv
python -m venv myenv
myenv\Scripts\activate  # Windows
source myenv/bin/activate  # Linux/Mac

2. 環境の確認を習慣化

# 現在の環境を確認
where python  # Windows
which python  # Linux/Mac

# インストール済みパッケージの場所を確認
pip list -v

3. requirements.txtで管理

# 環境を固定
pip freeze > requirements.txt

# 再現可能な環境構築
pip install -r requirements.txt

4. ユーザー環境は空に保つ

# 定期的にチェック
pip list --user
# 理想は「空」または最小限のツールのみ

注意点:pip uninstallには--userオプションがない

多くの人が勘違いしやすいポイント

  • pip install --user → ユーザー環境にインストール(存在する)
  • pip uninstall --user → このオプションは存在しない
  • pip uninstall → 自動的にユーザー環境・仮想環境の両方から探して削除

まとめ

今回のエラーは「仮想環境内のパッケージ」と「グローバル環境のパッケージ」の依存関係の衝突が原因でした。

重要なポイント

  • エラーメッセージは実際には警告で、インストール自体は成功していた
  • グローバル環境の汚染は、チーム開発でよくある問題
  • 仮想環境を正しく使えば、このような問題は防げる
  • 定期的にグローバル環境をチェックして、クリーンに保つことが重要

Python開発では仮想環境の管理が重要だということが、今回身に沁みました。
今回のような問題に遭遇したら、まずはpip showpip list --userで環境を確認するのがよさそうです

Read more

CEATEC 2025に出展します!フォトリアルAIアバター「MotionVox🄬」の最新版を実体験いただけます

CEATEC 2025に出展します!フォトリアルAIアバター「MotionVox🄬」の最新版を実体験いただけます

株式会社Qualitegは、2025年10月14日(火)~17日(金)に幕張メッセで開催される「CEATEC 2025」に出展いたします。今回の出展では、当社が開発したフォトリアリスティックAIアバター技術「MotionVox🄬」をはじめ、最新のAI技術とビジネスイノベーションソリューションをご紹介いたします。 出展概要 * 会期:2025年10月14日(火)~10月17日(金) * 会場:幕張メッセ * 出展エリア:ネクストジェネレーションパーク * ブース番号:ホール6 6H207 * CEATEC内特設サイト:https://www.ceatec.com/nj/exhibitor_detail_ja?id=1915 見どころ:最先端AI技術を体感できる特別展示 1. フォトリアルAIアバター「MotionVox🄬」 テキスト入力だけで、まるで本物の人間のような動画を生成できる革新的なAIアバターシステムです。 MotionVox🄬は自社開発している「Expression Aware🄬」技術により日本人の演者データを基に開発された、

By Qualiteg ニュース
その処理、GPUじゃなくて勝手にCPUで実行されてるかも  ~ONNX RuntimeのcuDNN 警告と対策~

その処理、GPUじゃなくて勝手にCPUで実行されてるかも ~ONNX RuntimeのcuDNN 警告と対策~

こんにちは! 本日は、ONNX RuntimeでGPU推論時の「libcudnn.so.9: cannot open shared object file」エラーの解決方法についての内容となります。 ONNX Runtimeを使用してGPU推論を行う際、CUDAプロバイダの初期化エラーに遭遇することがありますので、このエラーの原因と解決方法を解説いたします。 エラーメッセージの詳細 [E:onnxruntime:Default, provider_bridge_ort.cc:2195 TryGetProviderInfo_CUDA] /onnxruntime_src/onnxruntime/core/session/provider_bridge_ort.cc:1778 onnxruntime::Provider& onnxruntime::ProviderLibrary::Get() [ONNXRuntimeError] : 1 : FAIL : Failed to load

By Qualiteg プロダクト開発部
大企業のAIセキュリティを支える基盤技術 - 今こそ理解するActive Directory 第3回 クライアントとサーバーのドメイン参加

大企業のAIセキュリティを支える基盤技術 - 今こそ理解するActive Directory 第3回 クライアントとサーバーのドメイン参加

こんにちは、今回はシリーズ第3回クライアントとサーバーのドメイン参加について解説いたします! はじめに こんにちは!シリーズ第3回「クライアントとサーバーのドメイン参加」へようこそ。 前回(第2回)では、Active Directoryドメイン環境の構築手順について、ドメインコントローラーのセットアップからDNS設定まで詳しく解説しました。ドメイン環境の「土台」が整ったところで、今回はいよいよ実際にコンピューターをドメインに参加させる手順に進みます。 「ドメインユーザーアカウントを作ったのに、なぜかログインできない」「新しいPCを追加したけど、ドメイン認証が使えない」といった経験はありませんか?実は、Active Directoryの世界では、ユーザーアカウントを作成しただけでは不十分で、そのユーザーが使用するコンピューター自体もドメインに「参加」させる必要があるのです。 本記事では、このドメイン参加について、単なる手順の説明にとどまらず、「なぜドメイン参加が必要なのか」「裏側で何が起きているのか」という本質的な仕組みまで、初心者の方にも分かりやすく解説していきます。Win

By Qualiteg コンサルティング
使い捨てソフトウェア時代の幕開け ― 市場構造の根本的変革と日本企業

使い捨てソフトウェア時代の幕開け ― 市場構造の根本的変革と日本企業

こんにちは、株式会社Qualiteg コンサルティング部門です。 昨今、生成AIの急速な進化により、ソフトウェア開発の在り方が根本から変わりつつあります。2024年にはClaude、GPT-4、Geminiなどの大規模言語モデルがコード生成能力を飛躍的に向上させ、GitHub CopilotやCursor、Windsurf等の開発支援ツールが実際の開発現場で広く活用されるようになりました。さらに、Devin、OpenAI Canvas、Anthropic Claude Codingといった、より高度な自律的コーディング機能を持つAIエージェントも登場しています。 このような技術革新を背景に、当部門では今後のソフトウェア産業の構造変化について詳細な分析を行いました。本シリーズでは、特に注目すべき変化として、従来1000人月規模を要していた企業向けSaaSプラットフォームや、基幹システムが、AIエージェントを効果的に活用することで、わずか2-3名のチームが数日から数週間で実装可能になるという、開発生産性の劇的な向上について考察してまいります。 これは単なる効率化ではなく、ソフトウェア

By Qualiteg コンサルティング