unixzii/little-agent

little-agent는 경량 임베디드 에이전트 프레임워크 (Claude Code 및 OpenAI Codex와 유사)입니다. 이 프레임워크는 여러 모델 제공자 (model providers)를 지원하며 여러분의 애플리케이션에 쉽게 통합될 수 있습니다.

이미 전 세계적으로 많은 에이전트 프로젝트들이 존재하며, 이들은 실무 활용과 학습 측면 모두에서 가치가 있습니다. 하지만 저는 단순하고, 유지보수가 용이하며, 임베디드 가능한 저만의 에이전트를 만들고 싶었습니다. 지나치게 복잡한 메커니즘을 설계하는 대신, 저는 이 프로젝트를 KISS (Keep It Simple, Stupid) 원칙에 따라 유지하는 것을 선호합니다. 에이전트는 본질적으로 단순한 루프 (loop)입니다: 모델이 사용자 입력을 받고 도구 호출 (tool-call) 요청을 출력할 수 있습니다. 에이전트는 도구를 실행하고 그 결과를 다시 모델로 보냅니다. 이 루프는 더 이상의 도구 호출 요청이 없을 때까지 계속됩니다. 이러한 단순한 설계를 통해 저는 모델의 능력을 지속적으로 탐구하고자 합니다. 또한 이 프로젝트는 Rust로 작성되었고 C API를 내보내기 때문에, 저의 다른 애플리케이션에 통합하여 에이전트 기능 (agentic features)을 추가할 수 있습니다.

몇 가지 내장된 도구를 제공하며 즉시 사용할 준비가 된 little-agent 크레이트 (crate)를 사용하는 것을 권장합니다. 더 고급 사용 사례의 경우, 에이전트에 대한 더 세밀한 제어를 가능하게 하는 core 크레이트를 사용할 수도 있습니다.

little-agent는 또한 몇 가지 C API를 내보냅니다. 이를 동적 라이브러리 (dynamic library)로 빌드하고 여러분의 애플리케이션을 이에 링크할 수 있습니다. 인터페이스에 대해서는 include/little-agent.h를 참조하십시오.

Rust API의 경우, cargo doc을 실행하여 문서를 빌드하십시오.

이 프로젝트는 간단한 CLI도 제공합니다. 이는 기본적인 수준이며 주로 라이브러리 사용법을 보여주기 위한 목적으로 제작되었습니다.

CLI를 사용하려면 다음 환경 변수 (environment variables)를 설정해야 합니다:

export OPENAI_API_KEY="<Your API Key>"
export OPENAI_BASE_URL="https://api.openai.com/v1"
export OPENAI_MODEL="gpt-5.3"

단순히 cargo run을 실행하여 CLI를 구동하십시오.

MIT 라이선스 하에 배포됩니다. 자세한 내용은 LICENSE를 참조하십시오.