DeepSeek-Reasonix

KO | EN

gitlite — search

#typescript #python #javascript #react #machine-learning #csharp #redux #tailwindcss #cpp #mongodb #data-science #rust

DeepSeek-Reasonix

★ 34,643 Open GitHub ↗

터미널을 위한 DeepSeek 네이티브 AI 코딩 에이전트. 프리픽스 캐시 안정성을 중심으로 설계되어 백그라운드에서 계속 실행해 둘 수 있습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

English
 &nbsp;·&nbsp;
 <a href="./README.zh-CN.md">简体中文</a>
 &nbsp;·&nbsp;
 <a href="./docs/GUIDE.md">Guide</a>
 &nbsp;·&nbsp;
 <a href="./docs/ACP.md">ACP</a>
 &nbsp;·&nbsp;
 <a href="./docs/EXTENSIONS.md">Extensions</a>
 &nbsp;·&nbsp;
 <a href="./docs/SPEC.md">Spec</a>
 &nbsp;·&nbsp;
 <a href="https://esengine.github.io/DeepSeek-Reasonix/">Website</a>
 &nbsp;·&nbsp;
 <a href="https://discord.gg/XF78rEME2D">Discord</a>

<h3 align="center">터미널을 위한 DeepSeek 네이티브 AI 코딩 에이전트입니다.</h3>
설정 및 플러그인 기반의 하니스 — 단일 정적 Go 바이너리로 제공되며, DeepSeek의 프리픽스 캐시에 맞춰 최적화되어 긴 세션에서도 토큰 비용을 낮게 유지합니다.

> [!IMPORTANT]
> **Community · 加入社区** — 설정 관련 도움말(`#help` / `#求助`), 워크플로우 소개, 기능 아이디어를 나누는 다국어 Discord 커뮤니티입니다. → **<https://discord.gg/XF78rEME2D>**

## 주요 기능 (Features)

- **설정 기반 (Config-driven).** 프로바이더, 에이전트, 활성화된 도구 및 플러그인이 모두 `reasonix.toml`에 선언됩니다. 하드코딩된 모델이 없습니다.
- **다중 모델 및 조합 가능 (Multi-model & composable).** DeepSeek이 기본 프리셋으로 제공되며, OpenAI 호환 엔드포인트는 새 코드 작성 없이 설정 항목 추가만으로 사용할 수 있습니다. 선택적으로 캐시가 유지되는 별도의 세션에서 두 개의 모델(실행기 + 플래너)을 함께 실행할 수 있습니다.
- **플러그인 기반 (Plugin-driven).** MCP 서버가 도구, 프롬프트, 리소스를 제공하며, Extension Protocol v1 사이드카를 통해 런타임 이벤트를 가로채고, 프로바이더 및 구조화된 UI를 제공하며, 버전이 지정된 플러그인 패키지를 배포할 수 있습니다.
- **캐시 인식 컨텍스트 유지 관리 (Cache-aware context maintenance).** 시작 시 가벼운 안정적 환경 요약을 주입하고, 오래된 도구 출력은 요약 압축 전에 잘라내거나 제거하며, 내장된 도구 스키마 계약은 회귀 검토를 위해 문서화되어 있습니다.
- **제로 마찰 배포 (Zero-friction distribution).** `CGO_ENABLED=0` 단일 바이너리; 단일 명령어로 6개의 타겟에 교차 컴파일할 수 있습니다. 유일한 의존성은 TOML 파서입니다.

## 설치 (Install)

Reasonix를 사용하려는 방식에 맞는 경로를 선택하세요. CLI/TUI, 데스크톱 앱, VS Code 확장 프로그램 모두 동일한 로컬 Reasonix 엔진을 사용합니다.

### 경로 A: CLI / TUI

지원되는 모든 플랫폼에서 npm을 통해 네이티브 바이너리를 설치하거나, macOS에서는 Homebrew를 사용하세요.

```sh
npm i -g reasonix                  # 모든 OS; 사전 빌드된 네이티브 바이너리 다운로드
brew install esengine/reasonix/reasonix   # macOS
```

사전 빌드된 아카이브(`darwin|linux|windows × amd64|arm64`) 및 `SHA256SUMS`는 모든 [GitHub 릴리스](https://github.com/esengine/DeepSeek-Reasonix/releases)에서 확인할 수 있습니다.

### 경로 B: 데스크톱 앱

최신 데스크톱 빌드를 위해 [공식 다운로드 페이지](https://reasonix.io/?download=desktop#start)를 이용하세요.

| 플랫폼 | 패키지 | 아키텍처 |
| --- | --- | --- |
| macOS | 유니버설 `.dmg` 또는 `.zip` | Apple Silicon / Intel |
| Windows | 설치 프로그램 `.exe` 또는 포터블 `.zip` | x64 / ARM64 |
| Linux | `.deb` 또는 `.tar.gz` | x64 |

Windows 설치 도구는 [SignPath Foundation](https://signpath.org/)에서 제공하는 무료 인증서로 [SignPath.io](https://signpath.io/)를 통해 코드 서명되었습니다.

### 경로 C: VS Code 확장 프로그램

먼저 경로 A를 완료하세요. 이 확장 프로그램은 CLI를 번들로 포함하지 않으며, 로컬 `reasonix acp` 백엔드를 시작하여 네이티브 채팅, 편집기 컨텍스트, 도구 호출 승인, 모델 선택 및 워크스페이스 세션을 추가합니다.

- **VS Code:** [Visual Studio Marketplace에서 설치](https://marketplace.visualstudio.com/items?itemName=SivanLiu.reasonix-agent)
- **VSCodium / Eclipse Theia:** [Open VSX Registry에서 설치](https://open-vsx.org/extension/SivanLiu/reasonix-agent)
- **확장 프로그램 ID:** `SivanLiu.reasonix-agent` · [소스 및 사용 가이드](https://github.com/SivanCola/reasonix-vscode)

### 경로 D: 소스 코드에서 빌드

```sh
git clone https://github.com/esengine/DeepSeek-Reasonix.git
cd DeepSeek-Reasonix
make build      # -> bin/reasonix(.exe)
make cross      # -> dist/ (darwin|linux|windows × amd64|arm64)
```

## 빠른 시작 (Quick start)

### CLI / TUI

이 명령어들은 경로 A를 통해 설치된 CLI/TUI용입니다.

```sh
reasonix setup                      # 프로바이더 및 모델 설정
reasonix                            # 대화형 세션 시작
reasonix run "implement the TODOs in main.go"
```

대화형 세션에서 Reasonix가 프로젝트 지침을 생성하도록 하려면 `/init`을 실행하세요.

### 데스크톱 앱

[공식 다운로드 페이지](https://reasonix.io/?download=desktop#start)에서 플랫폼에 맞는 설치 프로그램을 다운로드하고, Reasonix를 설치 및 실행한 후 앱에서 프로바이더와 모델을 설정하세요. 데스크톱 앱의 경우 위의 CLI 명령어는 필요하지 않습니다.

고급 CLI 사용법 및 설정에 대해서는 **[CLI 레퍼런스](./docs/CLI.md)**, **[가이드](./docs/GUIDE.md)**, **[설정 경로](./docs/CONFIG_PATHS.md)**를 참고하세요.

## 문서 (Documentation)

- **시작하기:** [가이드](./docs/GUIDE.md) · [CLI 레퍼런스](./docs/CLI.md) · [설정 경로](./docs/CONFIG_PATHS.md) · [ACP 편집기 연동](./docs/ACP.md)
- **기능 및 문제 해결:** [서브에이전트 프로필](./docs/SUBAGENT_PROFILES.md) · [컨텍스트 엔진 v2](./docs/SESSION_MEMORY_RETRIEVAL.md) · [기능 진단](./docs/CAPABILITY_DIAGNOSTICS.md) · [복구 및 업데이트](./docs/RECOVERY.md) · [봇 가이드](./docs/BOT_GUIDE.md) · [체크포인트 및 되돌리기](./docs/CHECKPOINTS.md)
- **엔지니어링 및 마이그레이션:** [사양서](./docs/SPEC.md) · [태스크 계약 및 일시 중지 정책](./docs/TASK_CONTRACT.md) · [도구 계약](./docs/TOOL_CONTRACT.md) · [0.x 버전에서 마이그레이션하기](./docs/MIGRATING.md)
- **확장 프로그램 개발:** [확장 프로그램](./docs/EXTENSIONS.md) · [플러그인 패키지 및 매니페스트 v1](./docs/PLUGIN_PACKAGES.md) · [확장 프로그램 프로토콜](./docs/EXTENSION_PROTOCOL.md) · [Go SDK 및 스타터](./sdk/go/README.md)

## 스타 히스토리 (Star History)

## 감사의 말 (Acknowledgments)

Reasonix에 가장 큰 기여를 한 분들, 즉 커밋 수 기준 상위 20명의 기여자들입니다. 전체 기여자 그래프는 [GitHub](https://github.com/esengine/DeepSeek-Reasonix/graphs/contributors?all=1)에서 확인할 수 있습니다.

| Contributor | Contributor | Contributor | Contributor |
| --- | --- | --- | --- |
| [**SivanCola**](https://github.com/SivanCola) | [**esengine**](https://github.com/esengine) | [**ttmouse**](https://github.com/ttmouse) | [**lifu963**](https://github.com/lifu963) |
| **reasonix** (anonymous) | [**HUQIANTAO**](https://github.com/HUQIANTAO) | [**GTC2080**](https://github.com/GTC2080) | [**light-front-theory**](https://github.com/light-front-theory) |
| **merge-order-check** (anonymous) | [**Li-Charles-One**](https://github.com/Li-Charles-One) | [**eghrhegpe**](https://github.com/eghrhegpe) | **wufengfan** (anonymous) |
| [**CVEngineer66**](https://github.com/CVEngineer66) | [**dependabot\[bot\]**](https://github.com/apps/dependabot) | [**lanshi17**](https://github.com/lanshi17) | [**SuMuxi66**](https://github.com/SuMuxi66) |
| [**CnsMaple**](https://github.com/CnsMaple) | [**cyq1017**](https://github.com/cyq1017) | [**JesonChou**](https://github.com/JesonChou) | [**XTLine**](https://github.com/XTLine) |

또한 프로젝트 로고를 디자인해 주신 [**Bernardxu123**](https://github.com/Bernardxu123) 님과 XiaoHongShu에서 프로젝트를 홍보해 주신 [AIGC Link](https://xhslink.com/m/80ngts127cA)에도 감사의 말씀을 전합니다.

---

MIT — <a href="./LICENSE">LICENSE</a> 참고
 
 <a href="https://github.com/esengine/DeepSeek-Reasonix/graphs/contributors">esengine/DeepSeek-Reasonix</a>의 커뮤니티에서 빌드됨

---

프로젝트 후원하기 (Support this project)

Reasonix가 유용했고 감사를 표하고 싶다면 언제든 환영합니다. 후원은 커피 한 잔 값일 뿐 계약이 아닙니다 — 기부가 기능 우선순위를 구매하거나 이슈 처리 방식을 변경하지는 않습니다.

- **국제 (International)** — PayPal: [paypal.me/yuhuahui](https://paypal.me/yuhuahui)
- **중국 국내 (国内)** — 微信支付（扫码）

DeepSeek-Reasonix

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README