Python 버전 요구사항

CrewAI는 Python >=3.10 and <3.13 버전을 필요로 한다. 현재 설치된 Python 버전을 확인하려면 다음 명령어를 사용한다:

python3 --version

Python을 업데이트해야 한다면 python.org/downloads를 방문한다.

​
환경 설정하기

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

1

가상 환경 생성

원하는 방법으로 가상 환경을 생성한다:

venv 사용 (Python 내장 도구):

Terminal
python3 -m venv .venv

conda 사용:

Terminal
conda create -n crewai-env python=3.12
2

가상 환경 활성화

플랫폼에 따라 가상 환경을 활성화한다:

macOS/Linux (venv):

Terminal
source .venv/bin/activate

Windows (venv):

Terminal
.venv\Scripts\activate

conda 사용 (모든 플랫폼):

Terminal
conda activate crewai-env

​
CrewAI 설치하기

이제 CrewAI를 설치해 보자! 🚀

1

CrewAI 설치

다음 두 가지 방법 중 하나를 사용해 CrewAI와 모든 권장 도구를 설치한다:

Terminal
pip install 'crewai[tools]'

또는

Terminal
pip install crewai crewai-tools

두 방법 모두 핵심 패키지와 대부분의 사용 사례에 필요한 추가 도구를 설치한다.

2

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

이전 버전의 CrewAI가 설치되어 있다면 업그레이드할 수 있다:

Terminal
pip install --upgrade crewai crewai-tools

Poetry 관련 경고가 보이면 새로운 의존성 관리자로 마이그레이션해야 한다:

Terminal
crewai update

이 명령어는 프로젝트를 더 빠른 의존성 관리자인 UV로 업데이트한다.

새로 설치하는 경우 이 단계를 건너뛴다.

3

설치 확인

설치된 버전을 확인한다:

Terminal
pip freeze | grep crewai

다음과 같은 결과가 출력된다:

Output
crewai==X.X.X
crewai-tools==X.X.X
설치가 성공적으로 완료되었다! 이제 첫 번째 crew를 생성할 준비가 되었다.

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

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

1

프로젝트 구조 생성하기

CrewAI CLI 명령어를 실행한다:

Terminal
crewai create crew <project_name>

이 명령어는 다음과 같은 구조로 새로운 프로젝트를 생성한다:

my_project/
├── .gitignore
├── pyproject.toml
├── README.md
├── .env
└── src/
    └── my_project/
        ├── __init__.py
        ├── main.py
        ├── crew.py
        ├── tools/
        │   ├── custom_tool.py
        │   └── __init__.py
        └── config/
            ├── agents.yaml
            └── tasks.yaml
2

추가 도구 설치하기

UV를 사용해 추가 도구를 설치할 수 있다:

Terminal
uv add <tool-name>

UV는 pip보다 훨씬 빠르고 더 나은 의존성 해결 기능을 제공하므로 선호하는 패키지 매니저다.

3

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

프로젝트에는 다음과 같은 필수 파일이 포함된다:

파일목적
agents.yamlAI 에이전트와 역할 정의
tasks.yaml에이전트 작업과 워크플로우 설정
.envAPI 키와 환경 변수 저장
main.py프로젝트 진입점과 실행 흐름
crew.pyCrew 조율과 협업
tools/커스텀 에이전트 도구 디렉토리

agents.yaml과 tasks.yaml을 수정해 Crew의 동작을 정의하는 것부터 시작한다. API 키와 같은 민감한 정보는 .env에 보관한다.

​
다음 단계

첫 번째 에이전트 만들기

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

커뮤니티 참여하기

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

소개Quickstart