DeepSeek Harness

DeepSeek Harness(명령줄 이름 dsh)는 DeepSeek AI가 개발한 오픈 소스 Agent harness로, AI Agent를 실행하고 구성하는 데 사용합니다. 이 프로젝트는 everything-is-a-plugin(모든 것이 플러그인) 아키텍처를 채택했으며, 내부적으로 Cordis를 기반으로 합니다. Cordis의 설계 철학은 논문 「A Programming Paradigm for Spatiotemporal Composability」에서 확인할 수 있습니다.

⚠️ 개발자 프리뷰 버전: 프로젝트가 빠르게 변화하고 있으며, 호환성을 깨는 업데이트가 있을 수 있습니다. 실행하기 전에 저장소의 안전 안내(SAFETY.md)를 먼저 읽어 주세요.

주요 기능

• 플러그인 기반 아키텍처: 핵심 기능이 모두 플러그인 형태로 구성되어 있어 확장하고 조합하기 쉽습니다.
• Web UI: dsh web을 실행하여 시작하며, 기본 주소는 http://127.0.0.1:3080입니다. 로컬에서 시작하면 브라우저가 자동으로 열리고, SSH로 시작하면 주소만 출력합니다. --no-open 옵션을 추가하면 브라우저를 열지 않고 서비스만 실행합니다.
• 플러그인 생태계: 플러그인 저장소에 dsh-plugin topic을 추가하면 GitHub에서 검색해 찾을 수 있습니다.
• 데스크톱 지원: 저장소의 개발 문서와 Make 타깃에 Web과 Desktop 두 가지 애플리케이션 형태가 함께 언급되어 있습니다.
• 다국어 문서: README와 기여 가이드가 영어와 중국어 버전으로 제공됩니다.

대상 사용자 및 사용 시나리오

• AI Agent 실행 프레임워크를 구축하거나 연구하려는 개발자.
• 플러그인 메커니즘을 바탕으로 Agent 기능을 맞춤 설정하고, dsh 플러그인을 개발하고 공유하려는 커뮤니티 기여자.
• DeepSeek 공식 Agent 툴체인을 사용해 보고 싶은 기술 사용자.

설치 및 실행

npm으로 실행 (먼저 Node.js를 설치해야 합니다):

npx @deepseek-ai/dsh web

소스에서 실행:

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

개발 중에는 pnpm run dev:web을 사용할 수 있습니다. 하나의 터미널에서 빌드와 서비스 시작을 처리하고, 소스가 수정되면 클라이언트를 다시 빌드합니다.

기술 요구 사항 및 주의 사항

• Node.js 환경이 필요합니다. 소스에서 실행하려면 pnpm도 필요합니다.
• 저장소는 TypeScript가 중심이며 Python과 native 디렉터리도 포함하고 있습니다.
• MIT 라이선스를 사용하며, 서드파티 의존성과 해당 라이선스는 THIRD_PARTY_NOTICES.md에서 확인할 수 있습니다.
• 개발자 프리뷰 단계이므로 API와 동작이 언제든 바뀔 수 있으며, 안정성이 중요한 프로덕션 환경에서 바로 사용하는 것은 권장하지 않습니다.
• 문서 사이트: https://deepseek-harness.github.io/deepseek-harness/ ; 커뮤니티 소통에는 GitHub Discussions와 Discord를 이용할 수 있습니다.