huggingface/smolagents

어떤 프로젝트인가요?

핵심 기능

• 01CodeAgent가 동작을 Python 코드로 작성하고, 도구 호출을 함수 호출로 처리합니다.
• 02로컬 transformers 및 Ollama 모델, Hugging Face providers, OpenAI 호환 API, LiteLLM을 지원합니다.
• 03E2B, Modal, Blaxel 또는 Docker 같은 샌드박스에서 생성된 코드를 실행합니다.
• 04MCP 서버, LangChain, Hugging Face Spaces에서 도구를 가져옵니다.
• 05Hugging Face Hub를 통해 에이전트와 도구를 공유합니다.
• 06smolagent 및 webagent 명령줄 인터페이스를 제공합니다.

활용 사례

• 한 번의 실행에서 여러 웹 또는 API 도구를 호출하는 에이전트의 프로토타입을 만듭니다.
• 여러 단계의 추론이 필요한 리서치 또는 브라우징 어시스턴트를 구축합니다.
• 에이전트 워크플로에서 오픈소스 모델을 실험합니다.
• 코드 기반 에이전트와 JSON 도구 호출 에이전트의 차이를 가르치거나 학습합니다.

빠른 시작

1. 1

   기본 툴킷으로 패키지를 설치합니다

   pip install "smolagents[toolkit]"
2. 2

   도구와 모델을 지정해 CodeAgent를 정의한 다음 실행합니다

사용 전 알아둘 점

• !에이전트 코드를 안전하게 실행하려면 E2B, Blaxel, Modal 또는 Docker와 같은 외부 샌드박스가 필요합니다. 내장된 LocalPythonExecutor는 보안 경계가 아닙니다.
• !기본 데모 모델은 Hugging Face에서 호스팅되므로 일반적으로 제공업체 계정이나 API 키가 필요합니다.

토픽

자주 묻는 질문

smolagents은(는) 무엇인가요?

Python 코드로 동작을 작성하고 실행하는 AI 에이전트를 만들기 위한 미니멀한 Python 라이브러리입니다. smolagents는 LLM 기반 에이전트를 만들기 위한 소규모 Python 라이브러리입니다. 핵심 구성 요소인 CodeAgent는 각 동작을 Python 코드 조각으로 작성하므로, 도구 호출이 일반적인 함수 호출처럼 이뤄지고 한 단계에서 여러 도구를 차례로 사용할 수 있습니다. 에이전트 로직은 의도적으로 간결하게 유지해 주요 에이전트 모듈이 1,000줄 미만이며, 개발자가 소스 코드를 직접 읽고 수정할 수 있습니다.

smolagents은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

smolagents은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

smolagents은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. smolagents의 마지막 커밋은 2026년 10월 6일입니다.

smolagents은(는) 어디에 사용할 수 있나요?

한 번의 실행에서 여러 웹 또는 API 도구를 호출하는 에이전트의 프로토타입을 만듭니다. 여러 단계의 추론이 필요한 리서치 또는 브라우징 어시스턴트를 구축합니다. 에이전트 워크플로에서 오픈소스 모델을 실험합니다. 코드 기반 에이전트와 JSON 도구 호출 에이전트의 차이를 가르치거나 학습합니다.

smolagents는 어떻게 설치하나요?

기본 툴킷으로 패키지를 설치합니다: pip install "smolagents[toolkit]" 도구와 모델을 지정해 CodeAgent를 정의한 다음 실행합니다

smolagents은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/huggingface/smolagents