CrewAI 설치 및 프로젝트 시작

설치 방법

튜토리얼

⚠️ Python 버전 요구사항

CrewAI는 Python >=3.10 and <3.13을 요구합니다. 현재 버전 확인은 아래 명령어로 가능합니다:

python3 --version

CrewAI는 uv 라는 도구를 사용해 의존성 관리와 패키지 설치를 간편하게 처리합니다.

1단계: uv 설치

• macOS / Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

혹은 curl이 없다면:

wget -qO- https://astral.sh/uv/install.sh | sh

• Windows:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

문제가 있다면 uv 설치 가이드를 참고하세요.

2단계: CrewAI 설치

uv tool install crewai

• 설치 중 PATH 관련 경고가 뜨면 아래 명령어를 실행하세요:

uv tool update-shell

• 설치 확인:

uv tool list

crewai v0.102.0 등이 표시되어야 합니다.

• 업그레이드:

uv tool install crewai --upgrade

설치 완료 ✅

CrewAI 프로젝트 생성하기

1단계: 프로젝트 스캐폴딩 생성

crewai create crew <your_project_name>

예시 디렉터리 구조:

my_project/
├── .gitignore
├── knowledge/
├── 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단계: 구성 파일 수정하기

파일명	설명
agents.yaml	에이전트 역할 정의
tasks.yaml	에이전트 태스크 및 흐름 정의
.env	API 키, 환경 변수 등 민감 정보 저장용
main.py	프로젝트 실행 지점
crew.py	전체 크루 조율 로직
tools/	사용자 정의 도구 저장 디렉토리
knowledge/	참고 지식 정보 저장 디렉토리

agents.yaml과 tasks.yaml부터 수정해보며 시작하면 됩니다.

3단계: 프로젝트 실행하기

crewai install

• 추가 패키지 설치가 필요하면:

uv add <패키지명>

• 크루 실행:

crewai run