tjmlabs/AgentRun

어떤 프로젝트인가요?

핵심 기능

• 01실행 전에 생성된 코드의 위험한 작업을 검사합니다.
• 02격리된 Docker 컨테이너에서 코드를 실행합니다.
• 03CPU, 메모리, 스왑 및 타임아웃 제한을 설정할 수 있습니다.
• 04pip 의존성을 화이트리스트에 등록하고 미리 캐시할 수 있습니다.
• 05바로 실행할 수 있는 Docker Compose 기반 REST API를 제공합니다.
• 06Python을 로컬에서 실행할 때와 동일한 출력 및 트레이스백을 반환합니다.

활용 사례

• LLM 에이전트가 수학이나 데이터 관련 질문에 답하기 위해 코드를 실행하도록 합니다.
• 챗봇이나 AI 제품에 코드 인터프리터 기능을 추가합니다.
• 내부 도구용 샌드박스 코드 실행 서비스를 직접 호스팅합니다.

빠른 시작

1. 1

   GitHub 저장소를 클론합니다

   git clone https://github.com/Jonathan-Adly/agentrun
2. 2

   REST API 폴더로 이동합니다

   cd agentrun/agentrun-api
3. 3

   예제 파일을 사용해 환경 파일을 만듭니다

   cp .env.example .env.dev
4. 4

   Docker 서비스를 빌드하고 시작합니다

   docker-compose up -d --build

사용 전 알아둘 점

• !Docker가 설치되어 실행 중이어야 합니다.
• !pip 패키지를 사용하려면 직접 실행한 Docker 컨테이너를 제공해야 합니다.

포함된 컬렉션

토픽

자주 묻는 질문

AgentRun은(는) 무엇인가요?

LLM이 생성한 Python 코드를 리소스 제한, 타임아웃, 안전 검사를 적용해 격리된 Docker 컨테이너에서 실행하는 Python 라이브러리이자 REST API입니다. AgentRun을 사용하면 애플리케이션에서 대규모 언어 모델이 작성한 Python 코드를 샌드박스 환경에 전달하고, 예외와 트레이스백을 포함한 실행 결과를 받을 수 있습니다. Docker Python SDK와 RestrictedPython을 기반으로 하며, 코드는 호스트 시스템이 아닌 격리된 Docker 컨테이너 안에서 실행됩니다.

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

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

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

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

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

LLM 에이전트가 수학이나 데이터 관련 질문에 답하기 위해 코드를 실행하도록 합니다. 챗봇이나 AI 제품에 코드 인터프리터 기능을 추가합니다. 내부 도구용 샌드박스 코드 실행 서비스를 직접 호스팅합니다.

AgentRun는 어떻게 설치하나요?

GitHub 저장소를 클론합니다: git clone https://github.com/Jonathan-Adly/agentrun REST API 폴더로 이동합니다: cd agentrun/agentrun-api 예제 파일을 사용해 환경 파일을 만듭니다: cp .env.example .env.dev Docker 서비스를 빌드하고 시작합니다: docker-compose up -d --build

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

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