Buckets:

hf-doc-build
/

doc-dev

about 1 month ago

6.86 kB

설치 옵션[[installation-options]]

smolagents 라이브러리는 pip를 사용하여 설치할 수 있습니다. 사용 가능한 다양한 설치 방법과 옵션을 소개합니다.

smolagents를 Python 가상 환경 내에서 설치하는 것을 강력히 권장합니다. 가상 환경은 프로젝트의 의존성을 다른 Python 프로젝트와 시스템 Python 설치로부터 격리하여 버전 충돌을 방지하고 패키지 관리를 더욱 안정적으로 만들어줍니다.

venv 사용:

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

uv 사용:

uv venv .venv
source .venv/bin/activate

smolagents 핵심 라이브러리를 설치합니다:

pip install smolagents

uv pip install smolagents

smolagents는 필요에 따라 설치할 수 있는 여러 선택적 의존성(extras)을 제공합니다. 다음 구문을 사용하여 이러한 추가 기능을 설치할 수 있습니다:

pip install "smolagents[extra1,extra2]"

uv pip install "smolagents[extra1,extra2]"

다음 추가 기능은 다양한 도구와 통합을 포함합니다:

toolkit: 일반적인 작업을 위한 기본 도구 세트를 설치합니다.
```
pip install "smolagents[toolkit]"
```
mcp: 외부 도구 및 서비스와 통합하기 위한 Model Context Protocol (MCP) 지원을 추가합니다.
```
pip install "smolagents[mcp]"
```
toolkit: 일반적인 작업을 위한 기본 도구 세트를 설치합니다.
```
uv pip install "smolagents[toolkit]"
```
mcp: 외부 도구 및 서비스와 통합하기 위한 Model Context Protocol (MCP) 지원을 추가합니다.
```
uv pip install "smolagents[mcp]"
```

다음 추가 기능은 다양한 AI 모델 및 프레임워크와의 통합을 가능하게 합니다:

openai: OpenAI API 모델 지원을 추가합니다.
```
pip install "smolagents[openai]"
```
transformers: Hugging Face 트랜스포머 모델을 활성화합니다.
```
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]"
```
openai: OpenAI API 모델 지원을 추가합니다.
```
uv pip install "smolagents[openai]"
```
transformers: Hugging Face 트랜스포머 모델을 활성화합니다.
```
uv pip install "smolagents[transformers]"
```
vllm: 효율적인 모델 추론을 위한 VLLM 지원을 추가합니다.
```
uv pip install "smolagents[vllm]"
```
mlx-lm: MLX-LM 모델 지원을 활성화합니다.
```
uv pip install "smolagents[mlx-lm]"
```
litellm: 경량 모델 추론을 위한 LiteLLM 지원을 추가합니다.
```
uv pip install "smolagents[litellm]"
```
bedrock: AWS Bedrock 모델 지원을 활성화합니다.
```
uv pip install "smolagents[bedrock]"
```

다양한 미디어 유형 및 입력 처리를 위한 추가 기능:

vision: 이미지 처리 및 컴퓨터 비전 작업 지원을 추가합니다.
```
pip install "smolagents[vision]"
```
audio: 오디오 처리 기능을 활성화합니다.
```
pip install "smolagents[audio]"
```
vision: 이미지 처리 및 컴퓨터 비전 작업 지원을 추가합니다.
```
uv pip install "smolagents[vision]"
```
audio: 오디오 처리 기능을 활성화합니다.
```
uv pip install "smolagents[audio]"
```

코드를 원격으로 실행하기 위한 추가 기능:

docker: Docker 컨테이너에서 코드를 실행하는 지원을 추가합니다.
```
pip install "smolagents[docker]"
```
e2b: 원격 실행을 위한 E2B 지원을 활성화합니다.
```
pip install "smolagents[e2b]"
```
docker: Docker 컨테이너에서 코드를 실행하는 지원을 추가합니다.
```
uv pip install "smolagents[docker]"
```
e2b: 원격 실행을 위한 E2B 지원을 활성화합니다.
```
uv pip install "smolagents[e2b]"
```

텔레메트리, 모니터링 및 사용자 인터페이스 구성 요소를 위한 추가 기능:

telemetry: 모니터링 및 추적 지원을 추가합니다.
```
pip install "smolagents[telemetry]"
```
gradio: 대화형 Gradio UI 구성 요소 지원을 추가합니다.
```
pip install "smolagents[gradio]"
```
telemetry: 모니터링 및 추적 지원을 추가합니다.
```
uv pip install "smolagents[telemetry]"
```
gradio: 대화형 Gradio UI 구성 요소 지원을 추가합니다.
```
uv pip install "smolagents[gradio]"
```

사용 가능한 모든 추가 기능을 설치하려면 다음을 사용할 수 있습니다:

pip install "smolagents[all]"

uv pip install "smolagents[all]"

설치 후, 다음 코드를 실행해 smolagents가 올바르게 설치되었는지 확인할 수 있습니다:

import smolagents
print(smolagents.__version__)

smolagents를 성공적으로 설치했다면 다음을 수행할 수 있습니다:

Xet efficiently stores files, intelligently splitting them into unique chunks and accelerating uploads and downloads. More info.