Repolode
aden-hive

aden-hive/hive

지속적으로 작동하는 퀸 에이전트가 작업을 계획하고, 워커 에이전트를 병렬로 실행하며, 공유 SQLite 트래커에서 결과를 추적하는 오픈소스 런타임입니다.

스타
11,141
포크
5,634
열린 이슈
1,093
마지막 커밋
5일 전

어떤 프로젝트인가요?

Hive는 잠재 고객, 티켓, 저장소, 문서처럼 유사한 단위가 많은 비즈니스 작업에 AI 에이전트 군집을 실행하는 런타임입니다. 퀸 에이전트에게 원하는 결과를 설명하면, 퀸은 첫 번째 단위를 직접 처리하고 그 방법을 스킬로 저장한 다음 나머지 작업을 병렬 워커에게 분배합니다. 각 워커는 결과를 공유 SQLite 트래커에 기록하며, 이 결과는 조회하거나 감사하고 작업을 재개하는 데 활용할 수 있습니다.

Hive의 실행 기본 단위는 에이전트 루프 하나뿐입니다. 워커는 퀸을 복제한 에이전트로, 각자 별도의 작업과 더 제한된 도구 세트, 엄격한 도구 호출 한도를 갖습니다. 미리 정의된 그래프 대신 run_worker, run_playbook 같은 도구 호출을 통해 오케스트레이션이 이루어집니다. 에이전트 상태는 디스크에 저장되므로 충돌이나 재시작 후에도 작업을 이어갈 수 있으며, 크론, 간격 또는 웹훅 트리거로 에이전트 군집을 실행할 수 있습니다.

이 프로젝트에는 셸, 파일, 코드 검색, PDF, 웹 스크래핑, 차트용 기본 제공 도구와 브라우저에서 작업하는 에이전트를 위한 Chrome 확장 프로그램 브리지가 포함되어 있습니다. 모든 MCP 서버와 LiteLLM이 지원하는 모든 모델을 사용할 수 있으며, Ollama를 통한 로컬 모델도 지원합니다. 세션, 트래커, 메모리는 ~/.hive 아래에 일반 파일로 저장됩니다.

핵심 기능

  • 01세션이 바뀌어도 유지되는 역할과 Markdown 메모리를 갖춘 퀸 에이전트.
  • 02도구 호출로 실행되는 병렬 워커 에이전트와 동시 실행 수 제한.
  • 03워커가 결과를 기록하고 SQL로 조회할 수 있는 공유 SQLite 트래커.
  • 04상태를 디스크에 저장해 충돌 후 복구하고 이어서 실행할 수 있는 기능.
  • 05셸, 파일, PDF, 웹 스크래핑, 차트용 기본 제공 도구와 MCP 서버 지원.
  • 06OpenAI, Anthropic, Gemini 및 로컬 Ollama 모델을 포함한 LiteLLM 기반 모델 지원.

활용 사례

  • 여러 제품, 회사 또는 계정에 걸쳐 같은 질문을 병렬로 조사하기.
  • 재시도와 데드 레터 목록을 활용해 수백 건의 잠재 고객이나 티켓에 반복 가능한 프로세스 실행하기.
  • 재시작 후에도 실행을 이어가며 감사 가능한 결과를 생성해야 하는 예약 백그라운드 작업.
  • 주요 의사 결정 단계에서 사람의 승인을 거치는 브라우저 기반 또는 API 기반 작업 자동화.

빠른 시작

  1. 1

    저장소를 클론합니다

    git clone https://github.com/aden-hive/hive.git
  2. 2

    저장소 폴더로 이동합니다

    cd hive
  3. 3

    퀵스타트 스크립트를 실행합니다(macOS / Linux)

    ./quickstart.sh
  4. 4

    나중에 저장소에서 hive open을 실행해 대시보드를 엽니다

    hive open

사용 전 알아둘 점

  • git 외에도 Python 3.11 이상과 Node.js 20 이상이 필요합니다.
  • API 키나 코딩 구독이 필요하며, 또는 Ollama를 통한 로컬 모델을 사용할 수 있습니다.
  • 이 저장소는 uv 워크스페이스이므로 루트에서 pip install -e .를 실행해도 작동하지 않습니다. 대신 퀵스타트를 사용하세요.

포함된 컬렉션

토픽

자주 묻는 질문

hive은(는) 무엇인가요?
지속적으로 작동하는 퀸 에이전트가 작업을 계획하고, 워커 에이전트를 병렬로 실행하며, 공유 SQLite 트래커에서 결과를 추적하는 오픈소스 런타임입니다. Hive는 잠재 고객, 티켓, 저장소, 문서처럼 유사한 단위가 많은 비즈니스 작업에 AI 에이전트 군집을 실행하는 런타임입니다. 퀸 에이전트에게 원하는 결과를 설명하면, 퀸은 첫 번째 단위를 직접 처리하고 그 방법을 스킬로 저장한 다음 나머지 작업을 병렬 워커에게 분배합니다. 각 워커는 결과를 공유 SQLite 트래커에 기록하며, 이 결과는 조회하거나 감사하고 작업을 재개하는 데 활용할 수 있습니다.
hive은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
hive은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
hive은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. hive의 마지막 커밋은 2026년 11월 2일입니다.
hive은(는) 어디에 사용할 수 있나요?
여러 제품, 회사 또는 계정에 걸쳐 같은 질문을 병렬로 조사하기. 재시도와 데드 레터 목록을 활용해 수백 건의 잠재 고객이나 티켓에 반복 가능한 프로세스 실행하기. 재시작 후에도 실행을 이어가며 감사 가능한 결과를 생성해야 하는 예약 백그라운드 작업. 주요 의사 결정 단계에서 사람의 승인을 거치는 브라우저 기반 또는 API 기반 작업 자동화.
hive는 어떻게 설치하나요?
저장소를 클론합니다: git clone https://github.com/aden-hive/hive.git 저장소 폴더로 이동합니다: cd hive 퀵스타트 스크립트를 실행합니다(macOS / Linux): ./quickstart.sh 나중에 저장소에서 hive open을 실행해 대시보드를 엽니다: hive open
hive은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/aden-hive/hive

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트