> ## Documentation Index
> Fetch the complete documentation index at: https://crewai.burt.pe.kr/llms.txt
> Use this file to discover all available pages before exploring further.
# 설치
> CrewAI 시작하기 - 설치, 설정, 그리고 첫 번째 AI 크루 구축
**Python 버전 요구사항**
CrewAI는 `Python >=3.10 and <3.13` 버전을 필요로 한다. 현재 설치된 Python 버전을 확인하려면 다음 명령어를 사용한다:
```bash theme={null}
python3 --version
```
Python을 업데이트해야 한다면 [python.org/downloads](https://python.org/downloads)를 방문한다.
# 환경 설정하기
CrewAI를 설치하기 전에 가상 환경을 설정하는 것이 좋다. 이렇게 하면 프로젝트의 의존성을 분리하고 충돌을 방지할 수 있다.
원하는 방법으로 가상 환경을 생성한다:
**venv 사용 (Python 내장 도구):**
```shell Terminal theme={null}
python3 -m venv .venv
```
**conda 사용:**
```shell Terminal theme={null}
conda create -n crewai-env python=3.12
```
플랫폼에 따라 가상 환경을 활성화한다:
**macOS/Linux (venv):**
```shell Terminal theme={null}
source .venv/bin/activate
```
**Windows (venv):**
```shell Terminal theme={null}
.venv\Scripts\activate
```
**conda 사용 (모든 플랫폼):**
```shell Terminal theme={null}
conda activate crewai-env
```
# CrewAI 설치하기
이제 CrewAI를 설치해 보자! 🚀
다음 두 가지 방법 중 하나를 사용해 CrewAI와 모든 권장 도구를 설치한다:
```shell Terminal theme={null}
pip install 'crewai[tools]'
```
또는
```shell Terminal theme={null}
pip install crewai crewai-tools
```
두 방법 모두 핵심 패키지와 대부분의 사용 사례에 필요한 추가 도구를 설치한다.
이전 버전의 CrewAI가 설치되어 있다면 업그레이드할 수 있다:
```shell Terminal theme={null}
pip install --upgrade crewai crewai-tools
```
Poetry 관련 경고가 보이면 새로운 의존성 관리자로 마이그레이션해야 한다:
```shell Terminal theme={null}
crewai update
```
이 명령어는 프로젝트를 더 빠른 의존성 관리자인 [UV](https://github.com/astral-sh/uv)로 업데이트한다.
새로 설치하는 경우 이 단계를 건너뛴다.
설치된 버전을 확인한다:
```shell Terminal theme={null}
pip freeze | grep crewai
```
다음과 같은 결과가 출력된다:
```markdown Output theme={null}
crewai==X.X.X
crewai-tools==X.X.X
```
설치가 성공적으로 완료되었다! 이제 첫 번째 crew를 생성할 준비가 되었다.
# 새로운 프로젝트 생성하기
에이전트와 작업을 정의할 때 구조화된 접근 방식을 위해 YAML 템플릿 스캐폴딩을 사용하는 것을 권장한다.
CrewAI CLI 명령어를 실행한다:
```shell Terminal theme={null}
crewai create crew
```
이 명령어는 다음과 같은 구조로 새로운 프로젝트를 생성한다:
```
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
```
UV를 사용해 추가 도구를 설치할 수 있다:
```shell Terminal theme={null}
uv add
```
UV는 pip보다 훨씬 빠르고 더 나은 의존성 해결 기능을 제공하므로 선호하는 패키지 매니저다.
프로젝트에는 다음과 같은 필수 파일이 포함된다:
| 파일 | 목적 |
| ------------- | ----------------- |
| `agents.yaml` | AI 에이전트와 역할 정의 |
| `tasks.yaml` | 에이전트 작업과 워크플로우 설정 |
| `.env` | API 키와 환경 변수 저장 |
| `main.py` | 프로젝트 진입점과 실행 흐름 |
| `crew.py` | Crew 조율과 협업 |
| `tools/` | 커스텀 에이전트 도구 디렉토리 |
`agents.yaml`과 `tasks.yaml`을 수정해 Crew의 동작을 정의하는 것부터 시작한다.
API 키와 같은 민감한 정보는 `.env`에 보관한다.
## 다음 단계
빠른 시작 가이드를 따라 CrewAI 에이전트를 직접 만들어보고 실습해보세요.
다른 개발자들과 소통하고 도움을 받으며 CrewAI 경험을 공유해보세요.