#
설치 옵션

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

##
사전 요구사항

- Python 3.10 이상
- Python 패키지 관리자: `pip` 또는 `uv`

##
가상 환경

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

venv
uv

`venv` 사용:

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

##
기본 설치

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

pip
uv

    pip install smolagents

##
추가 기능과 함께 설치

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

pip
uv

    pip install "smolagents[extra1,extra2]"

###
도구

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

pip
uv

- toolkit: 일반적인 작업을 위한 기본 도구 세트를 설치합니다.

      pip install "smolagents[toolkit]"

- mcp: 외부 도구 및 서비스와 통합하기 위한 Model Context Protocol (MCP) 지원을 추가합니다.

      pip install "smolagents[mcp]"

###
모델 통합

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

pip
uv

- 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]"

###
멀티모달 기능

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

pip
uv

- vision: 이미지 처리 및 컴퓨터 비전 작업 지원을 추가합니다.

      pip install "smolagents[vision]"

- audio: 오디오 처리 기능을 활성화합니다.

      pip install "smolagents[audio]"

###
원격 실행

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

pip
uv

- docker: Docker 컨테이너에서 코드를 실행하는 지원을 추가합니다.

      pip install "smolagents[docker]"

- e2b: 원격 실행을 위한 E2B 지원을 활성화합니다.

      pip install "smolagents[e2b]"

###
텔레메트리 및 사용자 인터페이스

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

pip
uv

- telemetry: 모니터링 및 추적 지원을 추가합니다.

      pip install "smolagents[telemetry]"

- gradio: 대화형 Gradio UI 구성 요소 지원을 추가합니다.

      pip install "smolagents[gradio]"

###
전체 설치

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

pip
uv

    pip install "smolagents[all]"

##
설치 확인

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

    import smolagents
    print(smolagents.__version__)

##
다음 단계

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

- 안내서를 따라 기본 개념을 배워보세요.
- 실용적인 예제를 보고 싶다면 사용법 가이드를 살펴보세요.
- 고수준 설명을 보려면 개념 가이드를 읽어보세요.
- 에이전트 구축에 대한 심화 튜토리얼은 튜토리얼를 확인해보세요.
- 클래스와 함수에 대한 자세한 정보를 확인하고 싶으시면 API 레퍼런스를 살펴보세요.

Update on GitHub