Skip to main content
Python 버전 요구사항CrewAI는 Python >=3.10 and <3.13 버전을 필요로 한다. 현재 설치된 Python 버전을 확인하려면 다음 명령어를 사용한다:
Python을 업데이트해야 한다면 python.org/downloads를 방문한다.

​
환경 설정하기

CrewAI를 설치하기 전에 가상 환경을 설정하는 것이 좋다. 이렇게 하면 프로젝트의 의존성을 분리하고 충돌을 방지할 수 있다.
1

가상 환경 생성

원하는 방법으로 가상 환경을 생성한다:venv 사용 (Python 내장 도구):
Terminal
conda 사용:
Terminal
2

가상 환경 활성화

플랫폼에 따라 가상 환경을 활성화한다:macOS/Linux (venv):
Terminal
Windows (venv):
Terminal
conda 사용 (모든 플랫폼):
Terminal

​
CrewAI 설치하기

이제 CrewAI를 설치해 보자! 🚀
1

CrewAI 설치

다음 두 가지 방법 중 하나를 사용해 CrewAI와 모든 권장 도구를 설치한다:
Terminal
또는
Terminal
두 방법 모두 핵심 패키지와 대부분의 사용 사례에 필요한 추가 도구를 설치한다.
2

CrewAI 업그레이드 (기존 설치 시)

이전 버전의 CrewAI가 설치되어 있다면 업그레이드할 수 있다:
Terminal
Poetry 관련 경고가 보이면 새로운 의존성 관리자로 마이그레이션해야 한다:
Terminal
이 명령어는 프로젝트를 더 빠른 의존성 관리자인 UV로 업데이트한다.
새로 설치하는 경우 이 단계를 건너뛴다.
3

설치 확인

설치된 버전을 확인한다:
Terminal
다음과 같은 결과가 출력된다:
Output
설치가 성공적으로 완료되었다! 이제 첫 번째 crew를 생성할 준비가 되었다.

​
새로운 프로젝트 생성하기

에이전트와 작업을 정의할 때 구조화된 접근 방식을 위해 YAML 템플릿 스캐폴딩을 사용하는 것을 권장한다.
1

프로젝트 구조 생성하기

CrewAI CLI 명령어를 실행한다:
Terminal
이 명령어는 다음과 같은 구조로 새로운 프로젝트를 생성한다:
2

추가 도구 설치하기

UV를 사용해 추가 도구를 설치할 수 있다:
Terminal
UV는 pip보다 훨씬 빠르고 더 나은 의존성 해결 기능을 제공하므로 선호하는 패키지 매니저다.
3

프로젝트 커스터마이징하기

프로젝트에는 다음과 같은 필수 파일이 포함된다:
agents.yaml과 tasks.yaml을 수정해 Crew의 동작을 정의하는 것부터 시작한다. API 키와 같은 민감한 정보는 .env에 보관한다.

​
다음 단계

첫 번째 에이전트 만들기

빠른 시작 가이드를 따라 CrewAI 에이전트를 직접 만들어보고 실습해보세요.

커뮤니티 참여하기

다른 개발자들과 소통하고 도움을 받으며 CrewAI 경험을 공유해보세요.