# SpacesでのAim

**Aim**は、使いやすく、高性能なオープンソースの実験トラッカーです。Aimはトレーニング実行を記録し、それらを比較するための美しいUIと、プログラムでクエリするためのAPIを提供します。MLエンジニアや研究者は、Aimのエクスプローラーを使用して、数回のクリックで数千のトレーニング実行を比較できます。

Aimの詳細については、[Aimのドキュメント](https://aimstack.readthedocs.io/en/latest/)をご覧ください。新しい機能のアイデアやバグに気づいた場合は、[機能のリクエストを開くか、バグを報告](https://github.com/aimhubio/aim/issues/new/choose)してください。

次のセクションでは、Hugging Face HubのSpacesにAimをデプロイする方法と、Hubから直接トレーニングランを探索する方法を学びます。

## SpacesにAimをデプロイする

Aimは、ワンクリックでSpacesにデプロイできます!

    

Space を作成すると、`Building` ステータスが表示され、`Running,` になると、Space が利用可能になります。

次に、Spaceの**App**セクションに移動すると、Aim UIにアクセスできます。

## Spaces上でAimを使用して実験を比較

MNISTで訓練されたPyTorchのCNNの簡単な例を用いて、SpacesでのAimのエンドツーエンドデプロイメントをデモストレーションします。完全な例は[Aimリポジトリのexamplesフォルダ](https://github.com/aimhubio/aim/blob/main/examples/pytorch_track.py)にあります。

```python
from aim import Run
from aim.pytorch import track_gradients_dists, track_params_dists

# Initialize a new Run
aim_run = Run()
...
items = {'accuracy': acc, 'loss': loss}
aim_run.track(items, epoch=epoch, context={'subset': 'train'})

# Track weights and gradients distributions
track_params_dists(model, aim_run)
track_gradients_dists(model, aim_run)
```

Aimで追跡される実験は`.aim`フォルダに保存されます。**SpaceでAim UIを使用してログを表示するには、`.aim`フォルダを`tar.gz`ファイルに圧縮し、`git`またはSpaceのFiles and Versionsセクションを使用してSpaceにアップロードする必要があります。**

そのためのbashコマンドは以下の通りです:

```bash
tar -czvf aim_repo.tar.gz .aim
```

以上です!次に、Space の App セクションを開くと、ログ付きの Aim UI が利用できます。以下のような画面が表示されます:

![Aim UI on HF Hub Spaces](https://user-images.githubusercontent.com/23078323/232034340-0ba3ebbf-0374-4b14-ba80-1d36162fc994.png)

AimのPythonicな検索機能を使用して、実行をフィルタリングできます。トラッキングしているすべてのデータ（メトリクス、ハイパーパラメータなど）に対して、Pythonicな[クエリ](https://aimstack.readthedocs.io/en/latest/using/search.html)を記述できます。HF Hub Spaces上の[例](https://huggingface.co/aimstack)をご覧ください。

> [!TIP]
> ログがTensorBoard形式である場合、1つのコマンドでAimに変換し、利用可能な多くの高度で高性能なトレーニング実行の比較機能を使用できます。

## HF Spacesの詳細

- [HF Docker spaces](https://huggingface.co/docs/hub/spaces-sdks-docker)
- [HF Dockerスペースの例](https://huggingface.co/docs/hub/spaces-sdks-docker-examples)

## フィードバックとサポート

改善の提案やサポートが必要な場合は、[AimのGitHubリポジトリ](https://github.com/aimhubio/aim)でIssueを作成してください。

[AimコミュニティのDiscord](https://github.com/aimhubio/aim#-community)も、コミュニティの議論のために利用できます。