ApodexAI/FrontierAgent

FrontierAgent – 자율 AI 에이전트를 위한 오픈소스 런타임

정의 – FrontierAgent는 Python 기반의 터미널 우선 프레임워크로, 상태 저장 LLM 에이전트(ReAct 스타일) 또는 조정된 팀의 하위 에이전트를 장기간 파일 중심 작업에서 실행할 수 있게 해줍니다. 작업 보드, 샌드박스 파일 시스템, 실시간 도구 출력, 모든 작업의 추적을 표시하는 TUI(텍스트 UI)가 포함되어 있습니다.

주요 기능

기능	중요성
두 가지 내장 워크플로우 – react(단일 에이전트) 및 agent_team(코디네이터 + 병렬 하위 에이전트)	코드를 작성하지 않고도 간단한 연구 루프 또는 분해 및 합성 파이프라인을 선택할 수 있습니다.
샌드박스 파일 시스템 – /inputs(읽기 전용), /workspace(스크래치), /outputs(산출물)	재현성과 안전성을 보장합니다. 모든 파일 작업은 기록되고 되돌릴 수 있습니다.
비동기 개입 – 실행 중에 새 지시를 입력할 수 있습니다. 지시는 큐에 대기했다가 다음 안전한 턴에 주입됩니다.	장기 실행을 대화형으로 제어할 수 있습니다.
승인 및 추적 – 변경 작업은 diff를 표시하고 확인(또는 --yes)이 필요합니다. 전체 세션 체크포인트, 로그, --resume 플래그를 통해 중단한 지점에서 다시 시작할 수 있습니다.	우발적인 데이터 손실을 방지하고 디버깅에 도움이 됩니다.
평가 하네스 – 결정적 산출물 수집 및 병렬성 제어를 통해 수십 개의 연구 지향 벤치마크(BrowseComp, FrontierScience, GDPval 등)를 실행할 수 있는 하위 프로세스 러너.	자체 모델이나 번들된 Apodex-1.1 모델을 쉽게 벤치마킹할 수 있습니다.
플러그형 도구 – 웹 검색(Serper 또는 Parallel Search), 셸, 파일 조작, 사용자 지정 "팀" 도구가 기본 제공됩니다.	에이전트가 웹을 탐색하고, 명령을 실행하고, 파일을 읽고 쓸 수 있게 해줍니다.
모델에 구애받지 않음 – 모든 OpenAI 호환 엔드포인트(Apodex-1.1, 호스팅 서비스 또는 자체 호스팅 SGLang)에서 작동합니다.	직접 LLM을 호스팅할 필요가 없습니다. OPENAI_BASE_URL을 엔드포인트로 지정하기만 하면 됩니다.
Docker 및 네이티브 설치 – Linux/ARM용 사전 빌드 컨테이너 이미지, 선택적 GPU 가속 SGLang 서비스, 또는 uv를 통한 순수 Python 설치.	macOS, Linux, WSL2 또는 클라우드 GPU 인스턴스에서 유연하게 배포할 수 있습니다.

사용 방법

1. 설치 – 리포지토리를 클론하고 uv sync를 실행합니다(또는 전역 명령으로 uv tool install …).
2. 구성 – API 키와 엔드포인트를 .env(또는 사용자 전체 구성 파일)에 넣습니다.
3. 실행 – 단일 에이전트의 경우 uv run frontier-agent --mode react --cwd /my/project, 코디네이터가 병렬 하위 에이전트 간에 작업을 분할하도록 하려면 --mode agent_team을 사용합니다.
4. 상호 작용 – 에이전트가 작업하는 동안 후속 지시를 입력합니다. 지시는 큐에 대기합니다.
5. 검사 – TUI 사이드바에 작업 보드, 실시간 도구 출력, 파일 변경 diff가 표시됩니다.
6. 재개 / 되돌리기 – --resume으로 저장된 세션을 계속하거나 --revert로 파일 변경을 롤백합니다.

대상 사용자 – 파일 읽기/쓰기, 웹 탐색, 셸 명령 실행이 필요한 자율 에이전트를 위한 재현 가능하고 제어 가능한 환경이 필요한 연구자와 개발자. 특히 복잡한 다단계 벤치마크에서 새로운 LLM을 평가하는 데 유용합니다.

문서 및 리소스 –

• docs/의 전체 문서(프레임워크 아키텍처, TUI 가이드, 설치 선택기, 벤치마크 평가).
• README 상단에 링크된 기술 블로그 및 arXiv 보고서(Apodex-1.1).
• 커뮤니티 Discord, Hugging Face 모델 컬렉션, Apodex API 무료 2주 평가판.

라이선스 – Apache 2.0.

---

위의 모든 세부 사항은 리포지토리의 README에서 직접 가져온 것입니다. 추가 기능은 추론되지 않았습니다.