smolagents의 개요
smolagents는 Hugging Face의 작은 에이전트 라이브러리입니다. 주 클래스인 CodeAgent는 JSON 도구 호출을 하나씩 내보내는 대신, 도구를 호출하고 반복하고 값을 계산하는 짧은 Python 코드 조각으로 각 동작을 씁니다. 전통적인 JSON 방식을 위한 ToolCallingAgent도 있습니다.
에이전트가 스스로 쓴 코드를 실행하므로 README는 E2B, Blaxel, Modal, Docker 같은 샌드박스를 쓰라고 말합니다. 내장 LocalPythonExecutor는 README의 표현으로 보안 경계가 아닙니다.
로컬 transformers나 Ollama 모델, Hugging Face 추론 제공사, LiteLLM을 통한 상용 API와 동작하며, MCP 서버, LangChain, Hub Spaces에서 도구를 불러올 수 있습니다. 마지막 릴리스 v1.26.0은 2026년 5월 29일이었고, 8월 이후 커밋은 CI와 보안 정리입니다.
smolagents, 쓸 만한 가치가 있습니까?
smolagents는 의존성보다 교재로서 더 낫습니다. 마지막 릴리스 v1.26.0은 2026년 초까지 한 달에 두 번꼴로 이어지다가 2026년 5월 29일에 나왔습니다. 커밋은 계속됐지만 8월 이후 것은 GitHub Actions 고정, 토큰 범위 제한, 문서 빌더 버전 올리기이고, 기능을 더한 것은 없습니다. 스타 약 30,000개에 비해 열린 이슈 405개와 열린 풀 리퀘스트 590개가 있습니다.
아이디어는 여전히 타당하고 잘 논증돼 있습니다. 동작을 코드로 쓰면 에이전트가 한 단계에서 여러 도구 호출, 반복, 조건문을 엮을 수 있습니다. README는 JSON 도구 호출보다 단계가 30% 적고 따라서 모델 호출도 적다는 연구를 인용합니다. 핵심 에이전트 로직은 1,000줄 미만으로, 오후 한나절에 읽을 수 있습니다.
주의할 점: 보안 모델입니다. 모델이 쓴 Python을 안전하게 돌리려면 진짜 샌드박스가 필요하며, 로컬 실행기는 이미 뚫린 적이 있습니다. CVE-2025-5120과 CVE-2025-9959는 LocalPythonExecutor의 샌드박스 탈출이었고, README는 이제 그것이 보안 경계가 아니라고 분명히 말합니다. E2B, Blaxel, Modal, Docker는 운영하고 비용을 낼 두 번째 서비스를 더합니다.
오래가는 프로덕션 에이전트라면 Pydantic AI와 LangGraph가 smolagents가 사용자에게 맡기는 타입 지정 출력, 영속성, 트레이싱을 더 꾸준한 릴리스와 함께 제공합니다. 에이전트 전체를 Space로 올리는 것을 포함한 Hugging Face Hub 연동은 여전히 두 경쟁 제품이 따라오지 못하는 부분입니다.
제 역할을 하는 곳
에이전트 작업에서 오픈 모델을 비교하는 ML 연구자
Hub 모델이 얼마나 잘 계획하고 도구를 호출하는지 벤치마크하기
같은 CodeAgent와 저장소의 벤치마크 스크립트로 Hub나 Ollama를 통해 모델을 바꿔 가며 돌립니다. 라이브러리는 무료이고 비용은 추론입니다.
팀에게 에이전트의 동작 원리를 가르치는 엔지니어링 리드
프레임워크 추상화 없이 에이전트 루프를 처음부터 끝까지 보여 주기
1,000줄 미만의 agents.py는 한 번의 세션에 읽 을 수 있습니다. 실습이 노트북에서 생성된 코드를 절대 돌리지 않도록 Docker 샌드박스와 짝지으십시오.
2년짜리 제품을 위해 에이전트 프레임워크를 저울질하는 CTO
smolagents로 표준화할지 결정하기
다섯 달 동안 릴리스가 없고 열린 풀 리퀘스트가 590개라는 것은 유지보수 위험입니다. 나중에 포크하거나 옮길 예산을 잡거나, 릴리스가 더 꾸준한 프레임워크를 고르는 것이 신중한 선택입니다.
도입 전 확인할 점
- 설정
- Python 3.10 이상에서 pip install "smolagents[toolkit]"을 실행하면, Hub나 API 모델로 첫 CodeAgent를 몇 줄 만에 돌립니다. 신뢰할 수 없는 입력을 돌리기 전에 E2B, Modal, Blaxel, Docker 샌드박스를 추가하십시오.
- 연동
- transformers, Ollama, Hugging Face 추론 제공사, LiteLLM을 통한 모델. MCP 서버, LangChain, Hub Spaces의 도구. 에이전트를 Hub에 올리고 내려받을 수 있음.
- 데이터와 개인정보
- Apache 2.0. 설정한 모델과 샌드박스 제공사 외에는 아무 데도 아무것도 보내지 않습니다. CVE-2025-5120과 CVE-2025-9959는 LocalPythonExecutor의 샌드박스 탈출이었으 며, README는 이를 보안 경계로 써서는 안 된다고 말합니다.
- 대규모 사용 시 비용
- 라이브러리는 무료이고, 청구액은 모델 토큰과 E2B, Modal, Blaxel의 샌드박스 시간 또는 자체 Docker 호스트입니다.
- 제한
- 열린 이슈 405개와 열린 풀 리퀘스트 590개. 2026년 5월 29일 이후 릴리스 없음. 내장 영속성이나 지속 실행 없음.
좋은 점
- 동작을 코드로 쓰는 설계로 모델 호출 감소
- 1,000줄 미만의 핵심 로직
- transformers, Ollama, Hub 제공사, LiteLLM으로 어떤 모델이든
- MCP, LangChain, Hub Spaces의 도구
아쉬운 점
- 2026년 5월 이후 릴리스 없음, 최근 커밋은 정리 작업
- 로컬 실행기에 샌드박스 탈출 CVE가 있었음
- 영속성, 타입 지정 출력, 트레이싱 같은 프로덕션 기능이 적음
- 열린 풀 리퀘스트 590개
추천 대상
특히 오픈 모델로 코드를 쓰는 에이전트를 탐구하는 연구자와 학습자.
smolagents 대안
smolagents: 자주 묻는 질문
- smolagents, 쓸 만한 가치가 있습니까?
- 에이전트가 코드로 행동할 수 있다는 명료한 시연이지만, 이제 풀 리퀘스트 590개를 쌓아 둔 채 유지보수 모드로 흘러가고 있습니다. 평점은 5점 만점에 3.5점입니다.
- smolagents의 가격은 얼마입니까?
- Apache 2.0 라이선스의 무료 오픈소스입니다.
- smolagents의 단점은 무엇입니까?
- 2026년 5월 이후 릴리스 없음, 최근 커밋은 정리 작업; 로컬 실행기에 샌드박스 탈출 CVE가 있었음; 영속성, 타입 지정 출력, 트레이싱 같은 프로덕션 기능이 적음; 열린 풀 리퀘스트 590개.
- smolagents에 적합한 사람은 누구입니까?
- 특히 오픈 모델로 코드를 쓰는 에이전트를 탐구하는 연구자와 학습자.
- 팀이나 프로덕션 환경에서 smolagents의 비용은 얼마입니까?
- 라이브러리는 무료이고, 청구액은 모델 토큰과 E2B, Modal, Blaxel의 샌드박스 시간 또는 자체 Docker 호스트입니다.
- smolagents에 회사 데이터를 맡겨도 안전합니까?
- Apache 2.0. 설정한 모델과 샌드박스 제공사 외에는 아무 데도 아무것도 보내지 않습니다. CVE-2025-5120과 CVE-2025-9959는 LocalPythonExecutor의 샌드박스 탈출이었으며, README는 이를 보안 경계로 써서는 안 된다고 말합니다.
- smolagents의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Pydantic AI, OpenAI Agents SDK 및 LangGraph입니다.
답변 확인일: 2026년 10월 26일.