私的AI研究会 > CondaReview

Anaconda 環境構築

anaconda-logo.png
pypi_logo.png

 開発環境のもとになる「Anaconda」の Windows/Linux 環境下での構築についてまとめる

▲ 目 次
※ 最終更新:2024/07/18 

予備知識

 Python によるソフトウェア開発では、これまでのPython利用者たちが作り上げた、膨大なソフトウェア資産とそれらを利用できる環境が2種類用意されている。

PyPI (The Python Package Index)

Anaconda

CondaとPIP

仮想環境 conda と venv

Anaconda 概要

conda主要コマンド

機 能コマンド
パケージ一覧表示現在の仮想環境のパッケージ一覧表示conda list
指定した仮想環境のパッケージ一覧表示conda list -n py38
パッケージの検索公式リポジトリ内のパッケージを検索conda search tensorflow
チャネル内のパッケージを検索conda search -c conda-forge tensorflow
パッケージインストール公式リポジトリ内のパッケージをインストールconda install tensorflow
チャネル内のパッケージをインストールconda install -c conda-forge tensorflow
バージョン指定してインストールconda install tensorflow=1.15
パッケージの更新パッケージを最新にconda update tensorflow
すべてのパッケージを最新にconda update --all
パケージのアンインストールconda uninstall tensorflow
パケージの削除conda remove tensorflow
仮想環境作成pythonバージョンを指定して作成conda create -n py38 python=3.8
仮想環境をコピーして作成conda create -n py38 --clone base
環境設定ファイル(.yaml)から環境を再構築conda create -n py38 --file package-list.txt
仮想環境の削除conda env remove -n py38
仮想環境有効化conda activate py38
仮想環境の終了conda deactivate
現在の環境を設定ファイル(.yaml)に出力conda list --export > package-list.txt
conda のアップデートconda update -n base conda
condaのバージョンを表示conda -V
仮想環境の一覧表示conda info -e
conda 環境の表示conda info

pip/pip3 の主要コマンド

機 能コマンド
インストール済みのパッケージの詳細確認pip show <パッケージ名>
インストール済みパッケージ名とバージョン一覧pip list
最新版になっていないもののみ表示pip list –outdate
インストール済みパッケージ名とバージョン一覧(パッケージ管理除外)pip freeze
パッケージのインストールpip install <パッケージ名>
複数パッケージのインストールpip install <パッケージ名> <パッケージ名> ...
バージョンを指定してインストール
(バージョンを省略するとインストール可能なバージョン表示)
pip install <パッケージ名>==<バージョン>
GitHab からインストールpip install git+<repository-url>
パッケージのアップデートpip install -U <パッケージ名>
パッケージのアップデートpip install –update <パッケージ名>
インストール済みパッケージのアンインストールpip uninstall <パッケージ名>
複数インストール済みパッケージのアンインストールpip uninstall <パッケージ名> <パッケージ名> ... 
最新ファイルをDL(インストールはしない)pip download <パッケージ名>
pipのバージョンを表示pip -V
pipの主要コマンドとオプション一覧を表示pip help
pip コマンドの内容とオプションを表示pip <コマンド> -h

仮想環境について

anaconda の設定環境

(参考) conda 環境の設定・確認

anaconda 環境の構築  Windows 

anaconda アンインストール

  1. 「プログラムの追加と削除」から「Anaconda3 ... 」をアンインストールする
    `
  2. 下記の anaconda 関連ディレクトリに残っているフォルダ(ファイル)があればすべて削除する
    C:\ProgramData\Anaconda3
    C:\Users\<User>\.conda
    C:\Users\<User>\AppData\Local\conda
    C:\Users\<User>\anaconda3
    ※ バージョンによって関連ディレクトリの場所は異なる

anaconda のダウンロードとインストール

  1. オフィシャルサイト https://www.anaconda.com/products/distribution にアクセス

     ● 画面の「Download」ボタン(赤丸)を押してダウンロード

     ● ダウンロード・ファイル名(2023/12/12 現在)
      Anaconda3-2023.09-0-Windows-x86_64.exe

  2. インストーラ「Anaconda3-2023.09-0-Windows-x86_64.exe」を実行し手順に従ってインストールする

    ※ デフォールト設定でインストールする

anaconda 起動の設定

 ≪ PowerShell(推奨)≫

  1. 「スタートボタン」を押し「Anaconda Powershell Prompt (anaconda3)」の上で 右クリック → その他 → ファイルの場所を開く を選択する。
  2. 表示されるエクスプローラ上の「Anaconda Powershell Prompt (anaconda3)」で 右クリック → プロパティ を選ぶ。
  3. リンク先の項目を変更する。
    ・元の記述
    %windir%\System32\WindowsPowerShell\v1.0\powershell.exe -ExecutionPolicy ByPass -NoExit -Command "& 'C:\Users\<User>\Anaconda3\shell\condabin\conda-hook.ps1' ; conda activate 'C:\Users\<User>\anaconda3' "
    ・次のように変更 <User> = ユーザー名 X: = anaconda_winを配置したドライブ
    %windir%\System32\WindowsPowerShell\v1.0\powershell.exe -ExecutionPolicy ByPass -NoExit -Command "& 'C:\Users\<User>\anaconda3\shell\condabin\conda-hook.ps1' ; conda activate 'C:\Users\<User>\anaconda3'; Set-Location 'X:\anaconda_win' "

 ≪ コマンドプロンプト ≫

  1. 「Anaconda Prompt (anaconda3)」で 右クリック → プロパティ を選ぶ。
  2. リンク先の項目を変更する。
    ・元の記述
    %windir%\System32\cmd.exe "/K" C:\Users\<User>\anaconda3\Scripts\activate.bat C:\\Users\<User>\anaconda3
    ・次のように変更 <User> = ユーザー名 X: = anaconda_winを配置したドライブ
    %windir%\System32\cmd.exe "/K" C:\Users\<User>\anaconda3\Scripts\activate.bat C:\\Users\<User>\anaconda3 & cd /d X:\anaconda_win

環境変数の設定

  1. 検索ウィンドウに「システムの詳細設定」と入力し「システムの詳細設定」ダイアログを表示する。
  2. 「環境変数」ボタンを押して環境変数ダイアログを表示する。
  3. 新規に「PYTHONPATH」「X:\anaconda_win\workspace_py37\mylib;X:\anaconda_win\workspace\lib」(オリジナル Python 共有ライブラリの場所)を追加する
  4. そのほかの環境変数は、後でプロジェクトの環境設定で追加する

  5. 「Anaconda Powershell Prompt (anaconda3)」を再起動して設定を確認する。
    (base) PS > echo $env:PYTHONPATH
    C:\anaconda_win\workspace_py37\mylib;C:\anaconda_win\workspace\lib

anaconda を最新版にアップデート

  1. インストールされているすべてのパッケージを最新バージョンにアップデートする
    (base) PS > conda update --all
  2. Conda(Anacondaのパッケージマネージャー)をコマンドでアップデート
    (base) PS > conda update conda
  3. anaconda を再起動してバージョン確認
    (base) PS > conda -V
    ※ conda 24.1.2 (2024/03/02 現在)

PowerSell の設定

  1. 実行権限を設定する
    ・管理者として「Windows PowerShell」を起動して次のコマンドを実行
    Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
  2. プロファイルの作成
    ・プロファイルが作成される場所を確認
    $profile
    ・プロファイルが存在しなければ作成
    new-item -path $profile -itemtype file -force
    ※「Microsoft.PowerShell_profile.ps1」という空のファイルが作成される

  3. ファイル「Microsoft.PowerShell_profile.ps1」を修正する
    ・C:\Users\<User>\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1
    # PowerShell 動作確認
    echo 'Windows PowerShell'
    Get-Host
    
    # 'which' command
    function which($cmdname) {
      Get-Command $cmdname | Select-Object -ExpandProperty Definition
    }
  4. 「PowerShell」「Anaconda PowerShell」を再起動する
    Windows PowerShell
    
    Name             : ConsoleHost
    Version          : 5.1.22621.2506
    InstanceId       : 3ef6a3c4-1c1f-406d-8fe5-cec8caadc939
    UI               : System.Management.Automation.Internal.Host.InternalHostUserInterface
    CurrentCulture   : ja-JP
    CurrentUICulture : ja-JP
    PrivateData      : Microsoft.PowerShell.ConsoleHost+ConsoleColorProxy
    DebuggerEnabled  : True
    IsRunspacePushed : False
    Runspace         : System.Management.Automation.Runspaces.LocalRunspace
    
    (base) PS C:\anaconda_win>
  5. 'wkich': コマンドの実行パスを調べる
    (base) PS > which ls
    Get-ChildItem
    (base) PS > which python
    C:\Users\izuts\anaconda3\python.exe

ファイルシステムと anaconda の配置

 

anaconda 環境の構築  Linux 

anaconda のダウンロードとインストール

  1. オフィシャルサイト https://www.anaconda.com/products/distribution にアクセス

     ● 画面の「Download」ボタンを押してダウンロード

     ● ダウンロード・ファイル名(2024/02/29 現在)
      Anaconda3-2023.09-0-Linux-x86_64.sh

  2. ダウンロードファイル「Anaconda3-2023.09-0-Linux-x86_64.sh」を実行する
    $ cd ダウンロード
    $ ls
    Anaconda3-2023.09-0-Linux-x86_64.sh
    $ bash Anaconda3-2023.09-0-Linux-x86_64.sh
    
    Welcome to Anaconda3 2023.09-0
    
    In order to continue the installation process, please review the license
    agreement.
    Please, press ENTER to continue
    >>>             ← Enter入力
        :
    Do you accept the license terms? [yes|no]
    [no] >>> yes         ← yes入力
    
    Anaconda3 will now be installed into this location:
    /home/USER/anaconda3
    
      - Press ENTER to confirm the location
      - Press CTRL-C to abort the installation
      - Or specify a different location below
    
    [/home/USER/anaconda3] >>> ← Enter入力
        :
    You can undo this by running `conda init --reverse $SHELL`? [yes|no]
    [no] >>>           ← Enter入力
        :
    conda init
    
    Thank you for installing Anaconda3!

  3. インストールの確認
    $ source ~/anaconda3/etc/profile.d/conda.sh    ← conda 初期設定(ターミナル起動後一度だけ実行)
    $ conda -V                     ← conda バージョン表示
    conda 23.7.4
    $ conda info -e                  ← conda 仮想環境一覧表示
    # conda environments:
    #
    base                     /home/USER/anaconda3

ターミナル起動時に仮想環境を選択できるようにする

  1. 仮想環境の起動スクリプトを作成(仮想環境ごとに作る)
    ▼「anaconda_setup.sh」

  2. ターミナル起動スクリプトを作成
    ▼「env_select.sh」

  3. Anaconda 環境起動スクリプトに実行権限を付加する
    $ chmod u+x anaconda_setup.sh
    $ chmod u+x env_select.sh

  4. 「.bashrc」の最後に「source env_select.sh」の1行を追加する
        :
    source env_select.sh

環境変数の設定

  1. 仮想環境の起動スクリプトに環境変数設定を付加する
    ・例:「anaconda_setup.sh」
    #!/bin/sh
    
    echo "[anaconda_setup.sh] Anaconda3 (base) environment initialized"
    source $HOME/anaconda3/etc/profile.d/conda.sh
    
    echo "conda activate base"
    echo " Exit >> 'conda deactivate'"
    conda activate
    conda info -e
    echo
    
    export PYTHONPATH=$PYTHONPATH:$HOME/workspace_py37/mylib
    export PYTHONPATH=$PYTHONPATH:$HOME/workspace_2/mylib2
    echo " PYTHONPATH =" $PYTHONPATH
    echo
  2. 「ターミナル」を再起動して設定を確認する。
    (base) printenv PYTHONPATH
    :/home/mizutu/workspace_py37/mylib:/home/mizutu/workspace_2/mylib2

Anaconda 環境設定の確認方法

  1. 仮想環境にパスが通っていることの確認
    (***) $ which python
    (***) $ which pip
    (***) $ which conda
  2. python3, pip3 は,システムのものよりも,Anaconda のものが優先して使用されることの確認
    ※ 新しい版の anaconda では python, pip は python3, pip3 と同じ
    (***) $ which python3
    (***) $ which pip3
  3. python のバージョンの確認
    (***) $ python -V

ファイルシステムと anaconda の配置

 

更新履歴

参考資料