# Transformers Notebooks READMEの和訳
###### tags:`読書会`
このHackMDのメモには
https://github.com/nlp-with-transformers/notebooks
のREADME.mdの和訳(大橋による)を記載しています。
## Transformers Notebooks
このリポジトリは`O'Reilly book Natural Language Processing with Transformers`のサンプルコードを含むリポジトリです。
## Getting started
これらのノートブックは`Google Colab`のようなクラウドプラットフォームやローカルマシンで実行することができます。
合理的な時間で実行するためにはGPUが必要となることに注意してください、
そのため私たちはCUDAがプリインストールされたクラウドプラットフォームの使用をお勧めします。
## Running on a cloud platform
これらのノートブックをクラウドプラットフォームで使用するためには、下記テーブルのバッジをクリックしてください。
最近では、Colab上のGPUはK80(メモリ制限有)になる傾向があるため、Kaggle, Gradient, またはSageMaker Studio Labを使うことをお勧めします。
これらのプラットフォームはよりパフォーマンスの高いGPUであるP100を全て無料で使うことができる傾向があります。
注意: kaggleのようないくつかのクラウドプラットフォームは新しいパッケージをインストールした後にはnotebookを再起動することを要求するものがあります。
## Running on your machine
notebookをあなた自身のマシンで動作させるためには、まず最初に下記手順を参考にリポジトリをcloneしてください。
```sh
$ git clone https://github.com/nlp-with-transformers/notebooks.git
$ cd notebooks
```
次に、下記のコマンドをノートブックの実行に必要となる全てのライブラリを含むcondaの仮想環境を作成するために実行してください。
```sh
$ conda env create -f environment.yml
```
注意: 環境構築のためにはNVIDIAのCUDA ToolkitをサポートするGPUが必要になるでしょう。
これはApple silicon上では現在はローカル実行できないことを意味します😢.
Chapter 7 (質問回答)は特別な依存セットが必要となるため、そのチャプターのノートブック実行のためには異なる他の環境が必要となるでしょう。
```sh
$ conda env create -f environment-chapter7.yml
```
一度依存ライブラリのインストールを行って仕舞えば、conda環境をactivateすることができ、ノートブックを次のように起動することができます。
```sh
$ conda activate book # or conda activate book-chapter7
$ jupyter notebook
```
## FAQ
### notebookをKaggle上でcloneしようとする時に`I am unable to access the book's Github repository`というメッセージが出ます。どうすれば解決できますか?
この問題はおそらくインターネット接続が失われていることに起こるようです。Kaggle上で最初のnotebookを実行するときには右側のsettings menuからinternet accessを有効化する必要があります。
### KaggleでどうやってGPUを選択できますか?
設定メニュー右側のメニューでアクセラレータとしてGPUを選択することによってGPUが利用可能となります。
## 引用
If you'd like to cite this book, you can use the following BibTeX entry:
@book{tunstall2022natural,
title={Natural Language Processing with Transformers: Building Language Applications with Hugging Face},
author={Tunstall, Lewis and von Werra, Leandro and Wolf, Thomas},
isbn={1098103246},
url={https://books.google.ch/books?id=7hhyzgEACAAJ},
year={2022},
publisher={O'Reilly Media, Incorporated}
}