Hornet이 로컬 모델의 코딩 작업을 이어간다

Hornet은 로컬 언어 모델에 코딩 목표를 맡기고 대화가 끝난 뒤에도 작업 상태를 보존하는 명령줄 도구다. 작업을 파일 범위와 결과 형식, 완료 검사, 시도 횟수가 정해진 작은 단위로 나누며, 실패 기록과 복구 근거도 디스크에 저장한다.

Python 3.9 이상에서 사용할 수 있고 실행 시 필요한 Python 의존성은 없다. OpenAI 호환 LM Studio 서버를 포함해 로컬 모델을 사용하는 개발자를 대상으로 한다. PyPI 패키지 이름은 matrixswarm-hornet이다.

python -m pip install matrixswarm-hornet
python -m hornet --version
python -m hornet --help

완성된 목표를 체험하려면 v0.15.1 릴리스에서 스타터 ZIP과 SHA256SUMS, SHA256SUMS.asc, 공개 서명 키, VERIFY-RELEASE.md를 내려받아 검증한 뒤 압축을 풀고 내부의 START-HERE.md를 따르면 된다. 첫 목표 안내와 워커 설정을 먼저 읽어야 한다. 안내는 로컬 파일 계약 확인, Ubuntu 워커 VM 생성, 작은 Python 함수 수정 요청을 다룬다. 현재 스타터 VM 설정은 Windows와 VirtualBox를 대상으로 하며, 모델은 호스트에서 실행되고 에이전트 코드는 전용 VM 안에서 실행된다. 바로 설치할 수 있는 휠은 내려받은 스타터에 들어 있으며 GitHub의 자동 소스 아카이브에는 포함되지 않는다.

작업이 멈추거나 추가 결정이 필요할 때는 질문을 저장해 두고 답을 받은 뒤 재개할 수 있다.

hornet questions coding/recipes/RUN_ID
hornet answer coding/recipes/RUN_ID q-EXACT_QUESTION_ID --text "Use the existing configuration."
hornet autoresume coding/recipes/RUN_ID

답변은 실행 재개 전에 저장된다. waiting_for_user는 일시 정지 상태이며 completed와는 별도다. 답변을 기다리는 동안 백그라운드에서 모델을 반복 호출하지 않는다. 독립 실행형 work 작업에는 resume을 사용한다.

프로젝트가 공개한 0.15.0 첫 사용자 시험에서는 Gemma 12B가 작은 코딩 데모를 모델 요청 16회와 도구 호출 5회로 완료했고, 입력 토큰은 최대 3,084개였다. 변경된 파일은 calculator.py 하나였으며 독립 검사는 [-6, 0, 14]를 반환했고 기존 워커 기준 파일은 보존됐다. 이는 기존 Windows 호스트의 Ubuntu VM과 새 Python 환경에서 진행한 단일 목표 시험으로, 일반적인 모델 신뢰성 벤치마크는 아니다. 자세한 내용은 검증 기록에 있다.

워커는 현재 순차적으로 작업한다. 별도 목표 디렉터리도 VM 계정을 공유하므로 실행 경계는 전용 VM이 제공한다. 생성된 검사를 통과했다는 것은 검사한 동작에 관한 근거일 뿐이며, 내보낸 코드는 별도로 검토해야 한다.

소스에서 설치할 수도 있다.

git clone https://github.com/matrixswarm/hornet.git
cd hornet
python -m venv .venv

Windows에서는 다음 명령을 사용한다.

.\\.venv\\Scripts\\python.exe -m pip install .
.\\.venv\\Scripts\\hornet.exe --version

Linux와 macOS에서는 다음과 같이 설치한다.

.venv/bin/python -m pip install .
.venv/bin/hornet --version

PyPI의 0.15.1 휠과 소스 배포본은 서명된 GitHub 릴리스의 파일과 일치한다. 목표, 수정, 계약, 복구 명령은 CLI 문서에서 확인할 수 있다.

Hornet은 대니얼 F. 맥도널드(Daniel F. MacDonald)가 만들고 이끌었으며, AI 엔지니어링 협업은 AUTHORS.md에 기록돼 있다. 개발 방법은 CONTRIBUTING.md, 실행 경계와 보안 문제 제보는 SECURITY.md에서 안내한다. 라이선스는 AGPL-3.0-only이며 LICENSE에 명시돼 있다.