Anaconda食わず嫌いからの脱却

Pythonでコードを書くときにはPipenvを利用して仮想環境を構築することがほとんどなんですが、ここ最近GISデータを変換したり解析したりすることが多くなってきていて「あんまり詳しくないけどJupyterとか使ったら楽っぽいよなー」とか思ったのがきっかけでAnacondaやjupyterを利用し始めたのですが、これがとても快適だったので皆さんにもおすすめしていこうというやつです。

Anacondaはhomebrewとめちゃ相性が悪いとか他の仮想環境と競合してきついとかアンインストールできねぇとか色々聞きますが、アプリケーション開発時にはDockerを利用して環境構築することでそれらをほぼ無視することができると思うので、勇気を出してレッツトライ。

Anacondaをインストールする

こんな環境でやっていきます。

❯ sw_vers
ProductName:    macOS
ProductVersion: 12.4
BuildVersion:   21F79

こちらの記事とかとても参考になりました！
https://ai-inter1.com/python-install/#st-toc-h-3

基本的にはhttps://www.anaconda.com/products/distribution にアクセスすると勝手に自信のOSのインストーラーが選択されるので、一応確認してダウンロードするだけです。

「Download」をクリックすると（macであれば）.pkgファイルがダウンロードされるので、起動してインストーラーの指示に従うだけでインストールできると思います。

※注意

ちなみにご存知の方も多いとは思いますが、Anacondaは2020年より「大規模な環境での利用」は有料となっておりますのでご注意ください。
（https://qiita.com/tfukumori/items/f8fc2c53077b234384fc の記事などが参考になるかと思います。また、公式サイトもご確認ください）

Anacondaを使ってみる

インストールが終わるとランチャーにAnaconda-Navigatorが現れると思いますが、ターミナルから触れると何かと便利なので、コマンドラインで利用できるように設定します。

自分が利用しているシェルを調べて…

❯ echo $SHELL
/bin/zsh

初期化しましょう。

❯ conda init zsh
❯ source ~/.zshrc

※この段階ではもしかすると「condaコマンドが見つからないよ」と怒られるかもしれません。
その場合はパスを自分で通す必要があります。
おそらく/Users/<user_name>/opt/anaconda3/bin/ディレクトリにcondaコマンドが存在していると思いますので、これをパスに追加しましょう。

以下のようなコマンドを入力すると、確かにcondaという実行ファイルが存在していますね。

ll /Users/<user_name>/opt/anaconda3/bin/ | grep conda
...
-rwxrwxr-x  1 <user_name>  staff   528B  5 11 13:24 conda*
...

発見したら以下のコマンドでパスを追加し、そのまま初期化、そしてzshrcを実行しましょう

export PATH=/Users/<user_name>/opt/anaconda3/bin/:$PATH
/Users/<user_name>/opt/anaconda3/bin/conda init zsh
source ~/.zshrc

これでターミナルを再起動すると以下のようなコマンドでバージョンが表示されるはずです。

❯ conda -V
conda 4.12.0

これで準備OK！

（勝手に初期設定の仮想環境が立ち上がるのを防ぐ）

この段階では、どこでターミナルを開いてもcondaのbase仮想環境が立ち上がってしまうので、それを防ぎましょう。

conda config --set auto_activate_base false

仮想環境の作成とjupyter labをインストール

まずは適当に作業用フォルダを作りましょう。

mkdir jupyter_demo
cd jupyter_demo

次に仮想環境を作成してみましょう。セットアップが完了しているcondaコマンドを利用します。

途中で入力を求められるので「y」を押してエンターを押しましょう。

❯ conda create -n jupyter_demo
Collecting package metadata (current_repodata.json): done
Solving environment: done

## Package Plan ##

  environment location: ~/opt/anaconda3/envs/jupyter_demo

Proceed ([y]/n)? y

Preparing transaction: done
Verifying transaction: done
Executing transaction: done
#
# To activate this environment, use
#
#     $ conda activate jupyter_demo
#
# To deactivate an active environment, use
#
#     $ conda deactivate

次にアクティベートします。

conda activate jupyter_demo

するとこんな感じでターミナルのカーソルの上に(jupyter_demo)と表示されるはずです。

これで準備完了です。

(jupyter_demo) 
~/jupyter_demo via 🅒 jupyter_demo...
❯

仮想環境の名前を忘れてしまった場合は以下のコマンドで仮想環境の一覧を取得できます。

❯ conda info -e
# conda environments:
#
base                     ~/opt/anaconda3
jupyter_demo          *  ~/opt/anaconda3/envs/jupyter_demo

base仮想環境には初めからjupyterがインストールされていますが、jupyter_demo仮想環境がアクティブになっている状態でconda listコマンドでインストールされたパッケージを確認すると何もインストールされていません。

❯ conda list
# packages in environment at ~/opt/anaconda3/envs/jupyter_demo:
#
# Name                    Version                   Build  Channel

jupyter labをインストールしましょう。

インストール時に大量のパッケージがインストールされることを確認されますが、全てjupyter labの起動に必要ですので、先ほど同様に「y」を入力してエンターを押しましょう。

❯ conda install jupyterlab
...
  wheel              conda-forge/noarch::wheel-0.37.1-pyhd8ed1ab_0
  xz                 conda-forge/osx-64::xz-5.2.5-haf1e3a3_1
  zeromq             conda-forge/osx-64::zeromq-4.3.4-he49afe7_1
  zipp               conda-forge/noarch::zipp-3.8.0-pyhd8ed1ab_0
  zlib               conda-forge/osx-64::zlib-1.2.12-h6c3fc93_0

Proceed ([y]/n)? y

Downloading and Extracting Packages
xz-5.2.5             | 228 KB    | ################################################################################ | 100% 
psutil-5.9.1         | 357 KB    | ################################################################################ | 100% 
readline-8.1         | 266 KB    | ################################################################################ | 100% 
tornado-6.1          | 654 KB    | ################################################################################ | 100% 
importlib-metadata-4 | 33 KB     | ################################################################################ | 100% 
cffi-1.15.0          | 226 KB    | ################################################################################ | 100% 
tzdata-2022a         | 121 KB    | ################################################################################ | 100%
...

インストールされたかどうか確認します。

❯ conda list | grep jupyterlab
jupyterlab                3.4.2              pyhd8ed1ab_0    conda-forge
jupyterlab_pygments       0.2.2              pyhd8ed1ab_0    conda-forge
jupyterlab_server         2.14.0             pyhd8ed1ab_0    conda-forge

jupyter labを使ってみる

インストールが終わったので立ち上げてみましょう！jupyter labコマンドを実行するとhttp://localhost:8888 にサーバーが立ち上がります。

コマンドの最後に「.」をつけているのは、jupyterの作業ディレクトリをカレントディレクトリに指定するという意味です。

僕の環境では作業ディレクトリを別な場所に固定する設定を行っているため、ディレクトリの指定が必要になりますが、インストールしたての方であれば最後の「.」は不要かもしれません。

❯ jupyter lab .
...
		To access the server, open this file in a browser:
        file:///Users/satoru/Library/Jupyter/runtime/jpserver-3069-open.html
    Or copy and paste one of these URLs:
        http://localhost:8888/lab?token=29a214db46a619f58360a68c9cec2221c5950b3d1b15d7b4
     or http://127.0.0.1:8888/lab?token=29a214db46a619f58360a68c9cec2221c5950b3d1b15d7b4

サーバーが立ち上がると自動的にブラウザが立ち上がってこんな画面が表示されると思います。

されない方はブラウザを開いてhttp://localhost:8888 にアクセスしましょう！

試しにファイルを作ってPythonのコードを動かしてみましょう！

ファイル作成は右クリック（macでいうところのダブルタップ）→「New Notebook」ボタンから行えます。

クリックすると「カーネルは？」と聞かれるのでそのままSelectで決定しましょう！

すると画面左のサイドバーにUntitled.ipynbが作成されるので、適当に名前を変更しましょう！

ファイルにカーソルをあて、右クリックでRenameを選択し、ファイル名を入力します。

main.ipynbという名前に変更しました。.ipynbという拡張子はnotebookであることを表すので、変更しないようにしましょう。

画面右側のコンソールでpythonのコードを書き、shiftを押しながらエンターを押しましょう！

print("hello jupyter!")

すると想定通りの文字列が出力されましたね！これでjupyter環境を利用する準備ができました！！お疲れ様です！！

notebookの保存は一般的なエディターと同様にcommand + sを押すことで可能です。

仮想環境から抜ける・環境を削除する

その他詳しい利用方法などは良質な記事がたくさんあるのでそちらにお任せするとして…

仮想環境を抜けて環境を削除するところだけ説明していきます。

まずはサーバーを停止させましょう。

control + cを押した後、サーバーを停止するか聞かれるので「y」を入力してエンターで停止させましょう。

^C
[I 2022-06-03 07:25:11.901 ServerApp] 中断しました
ローカルディレクトリからノートブックをサーブ: ~/jupyter_demo
1 個のアクティブなカーネル
Jupyter Server 1.17.0 is running at:
http://localhost:8888/lab?token=xxxx
 or http://127.0.0.1:8888/lab?token=xxxx
Shutdown this Jupyter server (y/[n])? y
[C 2022-06-03 07:25:12.923 ServerApp] シャットダウンの確認
[I 2022-06-03 07:25:12.923 ServerApp] Shutting down 3 extensions
[I 2022-06-03 07:25:12.924 ServerApp] Shutting down 1 kernel
[I 2022-06-03 07:25:12.924 ServerApp] Kernel shutdown: 5cebd7fe-459f-4992-9ebc-0dc091e74f8a
[I 2022-06-03 07:25:13.139 ServerApp] Shutting down 0 terminals

❯

以下のコマンドで仮想環境を抜けます。すると、カーソル上部の(jupyter_demo)の文字が消えると思います。

conda deactivate

仮想環境を削除します。

conda env remove -n jupyter_demo

削除されたことを確認する。

conda info -eでもconda env listでもどちらでも確認できます。

しっかり削除されていそうですね！

❯ conda env list
# conda environments:
#
base                  *  ~/opt/anaconda3

お疲れ様でした！