프로젝트 소개

Argus는 AI 에이전트 빌더, RAG 파이프라인 및 운영 팀을 위한 검색 플랫폼으로, 여러 API를 직접 연결하지 않고도 검색, 콘텐츠 캡처 및 로컬 증거를 제공합니다. Python 패키지 argus-search(Python 3.11+ 런타임, MIT 라이선스)로 배포되며 현재 베타 단계로 설명됩니다. 핵심 아이디어: 여러 검색 제공업체 앞에 하나의 API를 두는 것입니다. 라우팅은 계층 기반입니다 — 무료 제공업체(SearXNG, DuckDuckGo, Yahoo, GitHub, WolframAlpha)를 먼저 사용하고, 그 다음 월간 반복 무료 계층(Brave, Tavily, Exa, Linkup, Parallel), 그 다음 일회성 크레딧 제공업체(Serper, You.com, Valyu)를 사용합니다. 예산이 소진된 제공업체는 자동으로 건너뜁니다. DuckDuckGo와 Yahoo는 키 없이 작동하므로 제로 구성 시작이 가능합니다. SearXNG는 Docker를 통해 자체 호스팅하여 70개 이상의 엔진을 하나의 엔드포인트 뒤에 집계할 수 있습니다. 원시 검색 외에도 Argus는 일시적인 JSON이 아닌 로컬 아티팩트를 생성하는 의견 기반 검색 워크플로우를 제공합니다: 죽거나 이동된 기사 복구(Wayback/archive 대체 사용), 사이트맵 지원 발견 및 링크 점수를 사용한 사이트의 중요한 페이지 캡처, 문서와 연구 팩 결합 구축. 런타임 코퍼스 데이터는 platformdirs(또는 ARGUS_DATA_ROOT)로 해결된 사용자 데이터 디렉토리에 기록되며, 저장소 체크아웃에는 기록되지 않습니다. 네 가지 검색 모드가 노출됩니다 — 발견, 연구, 복구 및 근거 — 결과에는 융합된 RRF 점수에 대한 제공업체별 점수 기여가 포함될 수 있습니다. session_id를 전달하여 다중 턴 세션이 지원되며, 세션 상태는 검색 원장에 사용되는 동일한 저장소를 통해 유지됩니다(프로덕션에서는 PostgreSQL, 직접 로컬 사용에서는 SQLite). 통합 경로: HTTP API(OpenAPI 문서, 루프백 호출은 인증 없음, 원격 호출자는 ARGUS_API_KEY 사용, /api/admin/* 아래 관리자 라우트), search, extract, recover-url, capture-site, build-research-pack, doctor, health, budgets 및 serve와 같은 명령이 있는 CLI, Claude Code, Codex CLI, OpenCode 및 Cursor와 같은 클라이언트를 위한 MCP 서버, 그리고 Python SDK. MCP 어댑터는 인증된 HTTP API 위의 상태 비저장 실행 어댑터로 설명되며, 개발용 독립형 로컬 브로커 모드가 존재하며 명시적으로 활성화해야 합니다. /dashboard의 대시보드는 제공업체 예산 소진, 소진 또는 초과 속도 제공업체, 30일 쿼리 볼륨, 머신별 사용량 및 최근 제공업체 활동을 보여줍니다. README는 또한 상태 페이지를 문서화하고 프로덕션 준비 상태가 현재 저하된 것으로 보고되며, 자격 증명 및 계정 범위 바인딩이 기록될 때까지 유료 제공업체가 허용되지 않으므로 제공업체 가용성을 의존하기 전에 상태 매트릭스와 대조 확인해야 한다고 명시합니다.