adolfousier/opencrabs

OpenCrabs – 자체 완결형 Rust 기반 AI 에이전트

개요 – OpenCrabs는 Rust로 작성된 터미널 전용 단일 바이너리 AI 어시스턴트입니다. HTTPS를 통해 LLM 제공업체(OpenAI, Anthropic, Gemini, Claude, Ollama 등)에 직접 연결하며, 모든 데이터를 로컬에 저장합니다(SQLite 채팅, 임베딩, brain 파일, API 키). 백그라운드 서버를 실행하지 않습니다. 프로젝트에는 ratatui 기반 TUI와 배포를 용이하게 하는 선택적 Docker 이미지가 포함되어 있습니다.

주요 기능

카테고리	특징
멀티 제공업체 지원	수십 개의 상용 및 로컬 모델과 연동 가능. 폴백 제공업체 체이닝 및 세션별 모델 전환 지원.
텔레메트리 제로, 로컬 우선	모든 채팅, 도구 실행, 메모리는 호스트에 유지됩니다. 발신 트래픽은 사용자가 트리거한 명시적인 LLM/API 호출로 제한됩니다.
3단계 메모리 시스템	• Brain 파일(사용자 큐레이션 마크다운) • 자동 요약이 포함된 일일 로그 파일 • FTS5 + 벡터 임베딩 하이브리드 검색. 작은 로컬 임베딩 모델로 오프라인 실행 또는 원격 /v1/embeddings 엔드포인트 사용 가능.
동적 도구 시스템	bash, git, 웹 검색, GitHub CLI, 브라우저 자동화(Chromium CDP), tools.toml로 정의된 범용 HTTP 도구 등 내장 도구.
멀티 에이전트 오케스트레이션	격리된 세션에서 실행되는 자식 에이전트(탐색, 코드, 리서치 등)를 생성하고 spawn_agent, wait_agent 등 명령어로 조정 가능.
자기 개선 루프 (실험적)	도구 사용 기록, 피드백 분석, 자체 brain 파일 자동 편집 및 모든 변경 사항 로깅.
멀티모달 입력	이미지(경로, URL, 클립보드) 및 비디오 첨부 가능. 에이전트는 제공업체별 비전 도구(예: Gemini)를 호출하여 분석.
로컬 음성	선택적 오프라인 Whisper-cpp 전사 및 TTS. 약 130MB에 모두 번들링됨.
사용량 대시보드	/usage로 프로젝트/제공업체별 토큰 수, 비용 추정, 활동 차트 표시.
보안 우선 설계	API 키는 RAM에서 제로화되고, 수신 리스너가 없으며, 바이너리는 단일 컴파일 산출물(약 35MB)입니다.

시작하기

1. 바이너리 설치 – 사전 빌드된 릴리스를 다운로드하거나 cargo install opencrabs로 빌드하거나 제공된 Docker 이미지를 실행합니다.
2. opencrabs 실행 – TUI가 온보딩 마법사와 함께 시작되며, keys.toml(제공업체 API 키) 및 선택적 config.toml 생성을 안내합니다.
3. 채팅 시작. 시스템 프롬프트는 brain 마크다운 파일(SOUL.md, AGENTS.md, TOOLS.md 등)에서 조립되며, 언제든지 편집할 수 있습니다.
4. 슬래시 명령(/goal, /cron, /tool …)으로 내장 기능을 트리거하거나 멀티모달 처리를 위해 파일을 첨부합니다.

문서 및 커뮤니티 – 전체 문서는 https://docs.opencrabs.com (6개 언어)에서 호스팅되며, 프로젝트의 GitHub 페이지에는 벤치마크, 아키텍처 다이어그램, "Full onboard" 영상이 포함되어 있습니다. 저장소는 적극적으로 유지 관리되고 있으며(CI 배지, Trendshift 랭킹), 기여를 환영합니다.

---

OpenCrabs는 프라이버시, 성능, 확장성에 초점을 맞춘 진정한 오픈소스 AI 에이전트 프레임워크로, 완전히 Rust로 구축되었습니다.