설치 (Installation)

smolagents는 pip으로 설치할 수 있어요. 설치 방법과 옵션이 어떻게 나뉘는지 차근차근 볼게요.

사전 요구사항

Python 3.10 이상
파이썬 패키지 매니저: pip 또는 uv

가상 환경 만들기

smolagents는 파이썬 가상 환경 안에 설치하는 것을 강력히 권장해요. 가상 환경은 프로젝트 의존성을 다른 파이썬 프로젝트나 시스템 파이썬과 격리시켜서, 버전 충돌을 막고 패키지 관리를 더 안정적으로 만들어준답니다.

venv를 쓰면 이렇게 해요.

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

uv를 쓴다면 이렇게요.

uv venv .venv
source .venv/bin/activate

기본 설치

핵심 라이브러리만 설치하려면 아래 명령을 실행해요.

pip install smolagents

uv를 쓴다면 uv pip install smolagents로 동일하게 설치하면 돼요.

엑스트라(추가 의존성)로 설치

smolagents는 필요에 따라 골라 쓸 수 있는 선택적 의존성(extras) 여러 개를 제공해요. 문법은 이렇게 돼요.

pip install "smolagents[extra1,extra2]"

도구(Tools) 관련 엑스트라

toolkit — 일반적인 작업을 위한 기본 도구 세트를 설치해요.
```
pip install "smolagents[toolkit]"
```
mcp — 외부 도구·서비스와 연동하기 위한 Model Context Protocol(MCP) 지원을 추가해요.
```
pip install "smolagents[mcp]"
```

모델 연동 엑스트라

다양한 AI 모델·프레임워크와 연동하기 위한 엑스트라들이에요.

openai — OpenAI API 모델 지원
```
pip install "smolagents[openai]"
```
transformers — Hugging Face Transformers 모델
```
pip install "smolagents[transformers]"
```
vllm — 고효율 추론을 위한 VLLM 지원
```
pip install "smolagents[vllm]"
```
mlx-lm — MLX-LM 모델 지원
```
pip install "smolagents[mlx-lm]"
```
litellm — 가벼운 모델 추론을 지원하는 LiteLLM
```
pip install "smolagents[litellm]"
```
bedrock — AWS Bedrock 모델 지원
```
pip install "smolagents[bedrock]"
```

멀티모달 엑스트라

다양한 미디어·입력을 처리하는 엑스트라예요.

vision — 이미지 처리·컴퓨터 비전 작업 지원
```
pip install "smolagents[vision]"
```
audio — 오디오 처리 기능
```
pip install "smolagents[audio]"
```

원격 실행 엑스트라

코드를 원격에서 실행하는 엑스트라예요.

blaxel — Blaxel 샌드박스 지원(빠르게 뜨는 VM, 권장)
```
pip install "smolagents[blaxel]"
```
e2b — 원격 실행 E2B 지원
```
pip install "smolagents[e2b]"
```
docker — Docker 컨테이너에서 코드 실행
```
pip install "smolagents[docker]"
```

텔레메트리와 UI 엑스트라

모니터링과 사용자 인터페이스 관련 엑스트라예요.

telemetry — 모니터링·트레이싱 지원
```
pip install "smolagents[telemetry]"
```
gradio — 대화형 Gradio UI 컴포넌트
```
pip install "smolagents[gradio]"
```

전체 설치

모든 엑스트라를 한 번에 설치하고 싶다면 이렇게 하면 돼요.

pip install "smolagents[all]"

설치 확인

설치가 잘 됐는지 아래처럼 버전을 출력해서 확인할 수 있어요.

import smolagents
print(smolagents.__version__)

다음 단계

가이드 투어를 따라 기본 사용법을 익혀보세요.
핵심 개념: 에이전트란에서 높은 수준의 설명을 읽어보세요.
보안 코드 실행 튜토리얼을 살펴보세요.

출처 인용

원문: smolagents - Installation Options (Hugging Face Docs)
원본 파일: huggingface/smolagents - docs/source/en/installation.md

설치 (Installation)