AutoGen Studio 설치

AutoGen Studio를 설치하는 방법은 크게 두 가지예요. PyPI에서 설치하거나 소스에서 설치하는 방법이죠. 소스 코드를 수정할 계획이 없다면 PyPI 설치를 권장해요.

출처: 공식문서 - AutoGen Studio 설치

가상 환경 만들기 (권장)

AutoGen Studio의 의존성을 시스템의 나머지 부분과 격리하려면 가상 환경을 쓰는 걸 추천해요.

venv

만들고 활성화하기:

Linux/Mac:

python3 -m venv .venv
source .venv/bin/activate

Windows 명령줄:

python3 -m venv .venv
.venv\Scripts\activate.bat

나중에 비활성화하려면:

deactivate

conda

아직 설치하지 않았다면 Conda 설치를 먼저 하세요.

만들고 활성화하기:

conda create -n autogen python=3.10
conda activate autogen

나중에 비활성화하려면:

conda deactivate

PyPI에서 설치 (권장)

AutoGen Studio는 파이썬 패키지 매니저 pip로 설치할 수 있어요.

pip install -U autogenstudio

소스에서 설치

참고: 이 방법은 React로 인터페이스를 빌드하는 데 어느 정도 익숙해야 해요.

소스에서 설치하는 방법은 직접 하거나 개발 컨테이너를 쓰는 두 가지가 있어요.

A) 소스에서 직접 설치

Python 3.10+ 와 Node.js(버전 14.15.0 이상)가 설치돼 있는지 확인하세요.
AutoGen Studio 저장소를 클론하세요.
python/packages/autogen-studio로 이동해 pip install -e .로 파이썬 의존성을 설치하세요.
python/packages/autogen-studio/frontend 디렉토리로 이동해 의존성을 설치하고 UI를 빌드하세요:

npm install -g gatsby-cli
npm install --global yarn
cd frontend
yarn install
yarn build
# Windows 사용자는 프론트엔드 빌드에 다른 명령이 필요할 수 있음:
gatsby clean && rmdir /s /q ..\\autogenstudio\\web\\ui 2>nul & (set "PREFIX_PATH_VALUE=" || ver>nul) && gatsby build --prefix-paths && xcopy /E /I /Y public ..\\autogenstudio\\web\\ui

B) 개발 컨테이너로 소스에서 설치

Dev Containers 튜토리얼을 따라 VS Code, Docker와 관련 확장을 설치하세요.
AutoGen Studio 저장소를 클론하세요.
VS Code에서 python/packages/autogen-studio/를 여세요. 아래쪽 모서리의 파란 버튼을 클릭하거나 F1을 누르고 "Dev Containers: Reopen in Container" 를 선택하세요.
UI를 빌드하세요:

cd frontend
yarn build

애플리케이션 실행

설치가 끝나면 터미널에 다음을 입력해 웹 UI를 실행해요.

autogenstudio ui --port 8081

이 명령은 지정한 포트에서 애플리케이션을 시작해요. 웹 브라우저를 열고 http://localhost:8081/로 가면 AutoGen Studio를 쓸 수 있어요.

AutoGen Studio는 애플리케이션을 맞춤 설정하는 몇 가지 파라미터도 받아요:

--host <host>: 호스트 주소 지정. 기본값은 localhost.
--appdir <appdir>: 앱 파일(데이터베이스, 생성된 사용자 파일 등)을 저장할 디렉토리 지정. 기본값은 사용자 홈 디렉토리의 .autogenstudio 디렉토리.
--port <port>: 포트 번호 지정. 기본값은 8080.
--reload: 코드가 변경될 때 서버를 자동 재로드. 기본값은 False.
--database-uri: 데이터베이스 URI 지정. 예: SQLite는 sqlite:///database.sqlite, PostgreSQL은 postgresql+psycopg://user:password@localhost/dbname. 지정하지 않으면 --appdir 디렉토리의 database.sqlite 파일을 기본으로 사용.
--upgrade-database: 데이터베이스 스키마를 최신 버전으로 업그레이드. 기본값은 False.

이제 AutoGen Studio를 설치하고 실행했으니, 에이전트 워크플로 정의·수정, 에이전트·세션과의 상호작용, 에이전트 스킬 확장 등 기능을 살펴볼 준비가 됐어요.

AutoGen Studio 설치