python fm playground

? Python FM プレイグラウンド

Python Foundation Model (FM) Playground へようこそ。これは、AWS SDK for Python である boto3 でAmazon Bedrock を使用する方法を探索するサンプルアプリです。

重要:このアプリケーションは教育目的であり、実稼働での使用を目的としたものではありません。

概要

このリポジトリには、 FastAPIアプリケーションとNext.jsフロントエンドが含まれており、どちらもローカルで実行可能です。以下は、動作中のアプリのスクリーンショットです。

重要

• このアプリケーションを実行すると、AWS アカウントに料金が発生する可能性があります。詳細については、「Amazon Bedrock の料金」を参照してください。
• このアプリはus-east-1で実行されるように構成されており、すべての AWS リージョンでテストされていません。詳細については、「AWS リージョン サービス」を参照してください。
• コードには最小限の権限、つまりアプリケーションに必要な最小限の権限のみを付与することをお勧めします。必要な権限を持つ IAM ポリシー文書は、このリポジトリのresources/bedrock-access-policy.json (ポリシーの表示) にあります。

前提条件

以下がインストールされていることを確認してください。

• バックエンドサーバー用の Python 3.8 以降。
• フロントエンド アプリケーション用の Node.js (v18.17+)。
• AWS アカウントが必要で、「AWS ツールと SDK の共有設定と認証情報リファレンス ガイド」の説明に従ってデフォルトの認証情報と AWS リージョンが設定されている必要があります。
• モデルを使用する前に、モデルへのアクセスをリクエストする必要があります。詳細については、「モデル アクセス」を参照してください。アプリを実行するには、 us-east-1の次のモデルにアクセスする必要があります。
  • 人間的なクロード
  • AI21 ラボ ジュラシック 2 ミッド
  • 安定AI 安定拡散XL

アプリケーションの実行

前提条件を確認した後、次の手順に従います。

リポジトリのクローンを作成する

ターミナルを開き、選択したディレクトリに移動して、次のコマンドを実行します。

git clone https://github.com/build-on-aws/python-fm-playground.git

仮想環境のセットアップ

Python プロジェクトには仮想環境を使用して、プロジェクトごとに依存関係を個別に管理することをお勧めします。まだ仮想環境にいない場合は、プロジェクト ディレクトリに移動して仮想環境を作成し、アクティブ化します。

Windows:

 cd python-fm-playground
python -m venv .venv
.venv S cripts a ctivate   

Linux/MacOS:

 cd python-fm-playground
python -m venv .venv
source .venv/bin/activate  

バックエンドのセットアップ

backendディレクトリに、仮想環境で次のコマンドを実行して必要なパッケージをインストールします。

pip install -r requirements.txt

インストールが成功したら、次のコマンドを実行してバックエンド サーバーを起動できます。

python main.py

サーバーが実行されると、次の出力が表示されます。

INFO:     Started server process [14712]
INFO:     Waiting for application startup.
INFO:     Application startup complete.
INFO:     Uvicorn running on http://0.0.0.0:55500 (Press CTRL+C to quit)

注:バックエンドはデフォルトでポート 55500 で実行されます。ポートの変更については以下を参照してください。

フロントエンドのセットアップ

新しいターミナル ウィンドウで、 frontendディレクトリに移動し、次のコマンドを実行して必要なパッケージをインストールします。

npm install

インストールが成功したら、次のコマンドを実行してフロントエンド アプリケーションを開始できます。

npm run dev

アプリケーションの実行中に、次の出力が表示されます。

 > [email protected] dev
> next dev

   ▲ Next.js 14.0.0
   - Local:        http://localhost:3000

 ✓ Ready in 3.3s

注:フロントエンドはデフォルトでポート 3000 で実行されます。ポートの変更については以下を参照してください。

アプリケーションへのアクセス

アプリケーションにアクセスするには、Web ブラウザでhttp://localhost:3000を開きます。

アプリケーションの停止

アプリケーションを停止するには、バックエンド プロセスとフロントエンド プロセスの両方を停止する必要があります。

フロントエンドの停止

フロントエンドが実行されているターミナルで、 Ctrl + C押してプロセスを終了します。

バックエンドの停止

同様に、バックエンド端末でCtrl + Cショートカットを使用してサーバーを停止します。

仮想環境の非アクティブ化

仮想環境を非アクティブにするには、バックエンド ターミナルを閉じるか、次のコマンドを実行します。

Windows:

.venv S cripts d eactivate.bat

Linux/MacOS:

deactivate

問題が発生した場合は、プロセス ID ( PID ) を見つけて、Unix ベースのシステムではkillコマンドを使用するか、Windows ではタスク マネージャーを使用して、プロセスを強制的に終了できます。

異なるポートの使用

次のファイルのバックエンド ポートを変更します。

• backend/config.py
• frontend/app/app.config.js

フロントエンドを別のポートで実行するには:

npm run dev -- --port NEW_PORT

トラブルシューティング

AWS リージョンはアプリケーションにハードコーディングされています。ただし、ローカルのAWS_REGION環境変数が別のリージョンに設定されている場合、アプリケーションが失敗する可能性があります。この場合、必ずAWS_REGIONの設定を解除するか、 us-east-1に設定してください。

ライセンス

このライブラリは、MIT-0 ライセンスに基づいてライセンスされています。 LICENSE ファイルを参照してください。

安全

詳細については、「貢献」を参照してください。