歡迎使用 Python Foundation Model (FM) Playground,這是一個範例應用程序,用於探索如何將Amazon Bedrock與 boto3(適用於 Python 的 AWS 開發工具包)結合使用。
重要提示:此應用程式用於教育目的,不適用於生產用途。
該儲存庫包括一個FastAPI應用程式和一個Next.js前端,兩者均可在本地執行。下面是該應用程式運行時的螢幕截圖。
us-east-1
中運行,尚未在每個 AWS 區域中進行測試。有關更多信息,請參閱 AWS 區域服務。resources/bedrock-access-policy.json
(顯示原則)中找到具有所需權限的 IAM 原則文件。 請確定您已安裝以下軟體:
us-east-1
中的以下模型:驗證先決條件後,請執行下列步驟:
開啟終端,導航到您選擇的目錄,然後執行以下命令:
git clone https://github.com/build-on-aws/python-fm-playground.git
建議為 Python 專案使用虛擬環境來單獨管理每個專案的依賴關係。如果您尚未處於虛擬環境中,請導航至專案目錄以建立並啟動虛擬環境:
cd python-fm-playground
python -m venv .venv
.venv S cripts a ctivate
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
快捷鍵來停止伺服器。
若要停用虛擬環境,只需關閉後端終端即可,或執行以下命令:
.venv S cripts d eactivate.bat
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 許可證獲得許可。請參閱許可證文件。
請參閱貢獻以獲取更多資訊。