echoVic/orca-agent

Orca란 무엇인가요?

Orca는 DeepSeek 거대 언어 모델과 대화하는 로컬 실행 방식의 터미널 기반 코딩 어시스턴트입니다. 소스 파일을 읽고, 편집하고, 생성하며, 셸 명령을 실행하고 결과를 검증할 수 있습니다. 이 모든 작업은 텍스트 기반 UI나 CI 파이프라인에서 작동하는 헤드리스 "exec" 모드에서 수행됩니다.

사용 방법

• 설치 – npm 글로벌 패키지 (npm i -g @blade‑ai/orca) 또는 미리 빌드된 Rust 바이너리를 다운로드하여 설치합니다.
• 실행 – orca를 입력하면 대화형 TUI가 열립니다. orca exec "fix the failing test"를 입력하면 UI 없이 단일 작업을 실행합니다. 세션은 저장, 재개 또는 포크할 수 있습니다.
• 작업 지시 – 자연어 지침을 입력하세요. Orca는 지침을 계획으로 변환하고, 도구(파일 편집, 셸 명령, 이미지 처리 등)를 호출하며, 모델의 추론 과정을 보여주고 필요할 때 승인을 요청합니다.
• 제어 – 단축키를 사용하여 도구 호출 승인, 중단, 백그라운드 작업, 하위 에이전트 보기, 여러 턴에 걸쳐 유지되는 "목표" 관리가 가능합니다.

주요 기능 (README 참조)

기능	설명
DeepSeek 네이티브	DeepSeek‑Flash 또는 DeepSeek‑V4‑Pro 모델을 사용하며 스트리밍 출력과 선택적 이미지 시각 분석을 지원합니다.
터미널 UI	멘션 (@), 스킬 삽입 ($), 명령 메뉴 (/), 이미지 붙여넣기 (Ctrl+V)를 지원하는 풍부한 TUI.
헤드리스 / CI 모드	orca exec는 스크립트화가 가능하며, 나중에 동일한 세션을 계속할 수 있도록 재개 명령을 출력합니다.
도구 샌드박싱	작업은 모드(suggest, auto‑edit, full‑auto, plan) 및 폴더별 신뢰 설정에 의해 제한됩니다.
하위 에이전트 및 워크플로우	동기 또는 비동기 하위 에이전트를 생성하며, 각 에이전트는 고유한 대화와 제어 권한을 가집니다.
영구 메모리	성공적인 작업 후 프로젝트별 사실을 학습하고 나중에 이를 기억할 수 있습니다.
MCP / ACP 통합	외부 "MCP" 서버(예: Pilion Browser)에 연결하고 에디터나 다른 도구를 위한 Agent Client Protocol을 노출합니다.
크로스 플랫폼	macOS, Linux, Windows (ARM & x64)용 바이너리 제공; npm을 통해서도 배포됩니다.
구성 가능	환경 변수, CLI 플래그 또는 ~/.orca/config.toml을 통해 설정 가능합니다.
신뢰성	취소, 체크포인트, 복구 기능을 처리하며 장시간 실행되는 명령을 UI로부터 격리합니다.

Orca가 유용한 사용자

• 개발자: 소스 코드를 클라우드로 보내지 않고 로컬 머신에서 코드를 수정할 수 있는 AI 어시스턴트를 원하는 분.
• CI/CD 파이프라인: 자동화된 "수정" 단계가 필요한 경우. orca exec는 컨테이너 내에서 실행될 수 있으며 예산 제한에 도달해도 재개할 수 있습니다.
• 파워 유저: 터미널 우선 워크플로우를 선호하면서도 모델이 이미지를 보거나 브라우저와 상호작용(Pilion 사용)하기를 원하는 분.

더 알아보기

• 전체 문서: https://orcaagent.dev/docs/
• 설치 스크립트 및 릴리스: https://github.com/echoVic/orca-agent/releases
• 커뮤니티 채팅: QQ 그룹 472309526, Telegram 링크는 README 참조.

---

위의 모든 정보는 프로젝트의 README에서 직접 가져온 것이며, 추가적인 주장은 포함되어 있지 않습니다.