> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sambanova.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Oumi

Oumi は、データ準備からトレーニング、評価、デプロイまで、基盤モデルのライフサイクル全体を簡素化するオープンソースのプラットフォームです。Oumi を通じて SambaNova 推論エンジンを利用する方法の詳細は、[Oumi SambaNova 推論エンジンの API リファレンス](https://oumi.ai/docs/en/latest/api/oumi.inference.html#oumi.inference.SambanovaInferenceEngine) をご覧ください。本ガイドでは、Oumi プラットフォーム上で SambaNova エンジンを連携・活用する手順を解説します。

## 前提条件

* [SambaCloud アカウント](http://cloud.sambanova.ai/?utm_source=oumi\&utm_medium=external\&utm_campaign=cloud_signup)と API キー
* Python 3.10 以上がインストールされていること

## セットアップ

<Steps>
  <Step title="Oumi のインストール">
    ```bash theme={}
    pip install oumi
    ```
  </Step>

  <Step title="API キーのエクスポート">
    ```bash theme={}
    export SAMBANOVA_API_KEY="your-sambacloud-api-key"
    ```
  </Step>
</Steps>

## 利用方法

`SambanovaInferenceEngine` を作成し、推論を実行します。

```python theme={}
from oumi.inference import SambanovaInferenceEngine
from oumi.core.configs import ModelParams, RemoteParams

engine = SambanovaInferenceEngine(
    model_params=ModelParams(
        model_name="Meta-Llama-3.3-70B-Instruct"
    ),
    remote_params=RemoteParams(
        api_key_env_varname="SAMBANOVA_API_KEY",
    )
)
```

<Note>
  会話の渡し方やレスポンスの取得方法を含む詳しい利用方法は、[Oumi SambaNova 推論エンジンの API リファレンス](https://oumi.ai/docs/en/latest/api/oumi.inference.html#oumi.inference.SambanovaInferenceEngine) をご参照ください。
</Note>

## トラブルシューティング

<AccordionGroup>
  <Accordion title="ModuleNotFoundError: oumi">
    * 有効化した仮想環境内で `pip install oumi` を実行してください
    * 仮想環境が有効になっていることを確認してください。`which python` の出力が `.venv` 内を指しているはずです
  </Accordion>

  <Accordion title="認証エラーまたは API キー未設定">
    * キーがエクスポートされていることを確認します: `echo $SAMBANOVA_API_KEY`
    * `export SAMBANOVA_API_KEY="your-key"` で再度エクスポートしてから再試行してください
    * `RemoteParams(api_key_env_varname="SAMBANOVA_API_KEY")` は実行時に環境変数を読み取るため、同じシェルセッションで設定されている必要があります
  </Accordion>

  <Accordion title="モデルが見つからない、またはモデル名が不正">
    * [SambaCloud のモデルページ](/docs/ja/models/sambacloud-models) でモデル名を確認してください
    * モデル名は大文字と小文字が区別されます。ポータルに表示されている文字列をそのまま使用してください
  </Accordion>

  <Accordion title="インストール時の Python バージョンエラー">
    * Oumi には Python 3.10 以上が必要です。`python --version` で確認してください
    * 古いバージョンを使用している場合は、Python 3.10 以上で新しい仮想環境を作成してください
  </Accordion>
</AccordionGroup>

## 参考情報

<CardGroup cols={2}>
  <Card title="Oumi API リファレンス" icon="book" href="https://oumi.ai/docs/en/latest/api/oumi.inference.html#oumi.inference.SambanovaInferenceEngine">
    会話・レスポンス・設定オプションを含む SambanovaInferenceEngine API の全リファレンス。
  </Card>

  <Card title="Oumi ドキュメント" icon="book-open" href="https://oumi.ai/docs/en/latest/">
    トレーニング、評価、推論を扱う Oumi の公式ガイド。
  </Card>

  <Card title="対応モデル" icon="layer-group" href="/docs/ja/models/sambacloud-models">
    SambaCloud で利用可能な最新のモデル一覧。
  </Card>

  <Card title="SambaCloud ポータル" icon="key" href="https://cloud.sambanova.ai/apis">
    SambaCloud の API キーの生成と管理。
  </Card>
</CardGroup>