mini_agent은(는) 무엇을 하나요?
Python으로 구현된 간소화된 Claude Code로, 다중 LLM 제공업체, Skill 메커니즘, 동시 Sub-Agent 오케스트레이션 및 완전한 도구 호출 체계를 지원합니다.
개요
mini_agent는 Claude Code의 핵심 개념을 Python으로 재현한 프로젝트입니다. 다양한 LLM 제공업체를 지원하며, Skill을 통해 기능을 확장하고, 여러 Sub-Agent를 동시에 실행하여 복잡한 워크플로우를 효율적으로 처리할 수 있습니다.
주요 기능
- 다중 LLM 제공업체 지원: OpenAI, Anthropic 등 다양한 LLM 제공업체와 호환됩니다.
- Skill 메커니즘: 플러그인 방식으로 새로운 기능을 추가하거나 사용자 정의 동작을 정의할 수 있습니다.
- 동시 Sub-Agent 오케스트레이션: 여러 하위 에이전트를 병렬로 실행하여 복잡한 작업을 분할 처리합니다.
- 완전한 도구 호출 체계: 파일 시스템 접근, 코드 실행, 웹 검색 등 다양한 도구를 에이전트가 호출할 수 있습니다.
설치
pip install mini-agent
또는 소스에서 직접 설치:
git clone https://github.com/onewaymyway/mini_agent.git
cd mini_agent
pip install -r requirements.txt
환경 변수
mini_agent를 실행하기 전에 다음 환경 변수를 설정하세요.
export LLM_API_KEY="your-api-key"
export LLM_PROVIDER="openai" # 또는 "anthropic"
export MINI_AGENT_SKILL_DIR="./skills" # Skills 디렉토리 경로 (선택 사항)
사용 방법
기본 실행
mini-agent "파이썬으로 웹 서버를 만들어 줘"
대화형 모드
mini-agent --interactive
Skill 목록 확인
mini-agent --list-skills
Skill 작성 방법
SKILL.md 파일을 생성하고 다음 형식을 따르세요.
---
name: my_custom_skill
description: 사용자 정의 Skill 설명
---
이 Skill은 특정 작업을 수행합니다. 환경 변수나 도구 호출에 대한 지침을 포함할 수 있습니다.
## 사용 예시
- 작업 1 수행
- 작업 2 수행
아키텍처
mini_agent는 다음과 같은 구성 요소로 이루어져 있습니다.
- 코어 엔진: LLM 호출, 메시지 처리, 컨텍스트 관리
- 도구 레이어: 파일 읽기/쓰기, 코드 실행, 셸 명령어 등
- Skill 매니저: 사용자 정의 Skill 로딩 및 실행
- 오케스트레이터: Sub-Agent 생성, 작업 분할, 결과 수집
기여 방법
- 이 저장소를 포크합니다.
- 기능 브랜치를 생성합니다 (
git checkout -b feature/amazing-feature). - 변경 사항을 커밋합니다 (
git commit -m 'Add amazing feature'). - 브랜치에 푸시합니다 (
git push origin feature/amazing-feature). - Pull Request를 생성합니다.
라이선스
MIT License - 자세한 내용은 LICENSE 파일을 참조하세요.