python fm playground

? 파이썬 FM 놀이터

Python용 AWS SDK인 boto3와 함께 Amazon Bedrock을 사용하는 방법을 탐색하는 예제 앱인 Python Foundation Model(FM) Playground에 오신 것을 환영합니다.

중요: 이 애플리케이션은 교육 목적으로 제작되었으며 프로덕션 용도로 사용되지 않습니다.

개요

이 저장소에는 로컬에서 실행 가능한 FastAPI 애플리케이션과 Next.js 프런트엔드가 포함되어 있습니다. 아래는 실제 앱의 스크린샷입니다.

중요한

• 이 애플리케이션을 실행하면 AWS 계정에 요금이 부과될 수 있습니다. 자세한 내용은 Amazon Bedrock 가격을 참조하세요.
• 이 앱은 us-east-1 에서 실행되도록 구성되었으며 모든 AWS 리전에서 테스트되지 않았습니다. 자세한 내용은 AWS 지역 서비스를 참조하십시오.
• 코드에 최소 권한, 즉 애플리케이션에 필요한 최소 권한만 부여하는 것이 좋습니다. resources/bedrock-access-policy.json (표시 정책)의 이 리포지토리에서 필요한 권한이 있는 IAM 정책 문서를 찾을 수 있습니다.

전제 조건

다음이 설치되어 있는지 확인하십시오.

• 백엔드 서버용 Python 3.8+.
• 프론트엔드 애플리케이션용 Node.js(v18.17+).
• AWS 계정이 있어야 하며, AWS 도구 및 SDK 공유 구성 및 자격 증명 참조 가이드에 설명된 대로 기본 자격 증명과 AWS 리전이 구성되어 있어야 합니다.
• 모델을 사용하려면 먼저 해당 모델에 대한 액세스를 요청해야 합니다. 자세한 내용은 모델 액세스를 참조하세요. 앱을 실행하려면 us-east-1 에서 다음 모델에 액세스해야 합니다.
  • 인류애적인 클로드
  • AI21 연구소 Jurassic-2 Mid
  • 안정성 AI 안정 확산 XL

애플리케이션 실행

필수 구성 요소를 확인한 후 다음 단계를 따르세요.

저장소 복제

터미널을 열고 원하는 디렉터리로 이동한 후 다음 명령을 실행합니다.

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   

리눅스/맥OS:

 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에서 실행됩니다. 포트 변경은 아래를 참조하세요.

애플리케이션에 액세스

애플리케이션에 액세스하려면 웹 브라우저에서 http://localhost:3000 엽니다.

애플리케이션 중지

애플리케이션을 중지하려면 백엔드 및 프런트엔드 프로세스를 모두 중지해야 합니다.

프런트엔드 중지

프런트엔드가 실행 중인 터미널에서 Ctrl + C 눌러 프로세스를 종료합니다.

백엔드 중지

마찬가지로 백엔드 터미널에서 Ctrl + C 단축키를 사용하여 서버를 중지합니다.

가상 환경 비활성화

가상 환경을 비활성화하려면 백엔드 터미널을 닫거나 다음 명령을 실행하면 됩니다.

윈도우:

.venv S cripts d eactivate.bat

리눅스/맥OS:

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 라이선스에 따라 라이선스가 부여됩니다. 라이센스 파일을 참조하십시오.

보안

자세한 내용은 기여를 참조하세요.