DeepSeek-Reasonix README

The project's README from github.com/esengine/DeepSeek-Reasonix. As one markdown file: README.md.

Reasonix

English  ·  简体中文  ·  Guide  ·  ACP  ·  Extensions  ·  Spec  ·  Website  ·  Discord

npm version CI license downloads GitHub stars AtomGit stars contributors Discussions Discord

esengine/DeepSeek-Reasonix | Trendshift esengine/DeepSeek-Reasonix | Trendshift


Open source · MIT · a single Go binary

A coding agent you can leave running.

One local engine, four ways in — terminal, desktop app, browser, or your editor over ACP. Plan mode, permissions, a workspace sandbox and per-turn checkpoints keep a long autonomous run something you can still read and undo.


[!IMPORTANT] Community · 加入社区 — bilingual Discord for setup help (#help / #求助), workflow showcases, and feature ideas. → https://discord.gg/XF78rEME2D


Features

Install

Choose the path that matches how you want to use Reasonix. The CLI/TUI, desktop app, and VS Code extension all use the same local Reasonix engine.

Path A: CLI / TUI

Install the native binary through npm on any supported platform, or use Homebrew on macOS:

npm i -g reasonix                  # any OS; pulls the prebuilt native binary
brew install esengine/reasonix/reasonix   # macOS

Prebuilt archives (darwin|linux|windows × amd64|arm64) and SHA256SUMS are on every GitHub release.

Path B: Desktop app

Use the official download page for the latest desktop build.

Platform Package Architecture
macOS Universal .dmg or .zip Apple Silicon / Intel
Windows Installer .exe or portable .zip x64 / ARM64
Linux .deb or .tar.gz x64

Windows installers are code-signed through SignPath.io with a free certificate provided by the SignPath Foundation.

Path C: VS Code extension

Complete Path A first. The extension does not bundle the CLI; it starts your local reasonix acp backend and adds native chat, editor context, tool-call approvals, model selection, and workspace sessions.

Path D: Build from source

Clone the repository first:

git clone https://github.com/esengine/DeepSeek-Reasonix.git
cd DeepSeek-Reasonix

CLI

The CLI build requires Go 1.26+. The module pins a toolchain directive; keep GOTOOLCHAIN=auto so Go downloads the pinned toolchain, or install it.

make build      # -> bin/reasonix(.exe)
make cross      # -> dist/ (darwin|linux|windows × amd64|arm64)

Desktop

The desktop build additionally requires Node 24+ and pnpm 10 (npm install -g pnpm@10) for the frontend and the Electron shell:

scripts/desktop-build.sh darwin/arm64 v0.0.0-dev   # one platform per run

No platform webview dependencies are needed — the shell ships its own Chromium. See the desktop build guide.

Quick start

CLI / TUI

These commands are for the CLI/TUI installed through Path A:

reasonix setup                      # configure a provider and model
reasonix                            # start an interactive session
reasonix run "implement the TODOs in main.go"

In an interactive session, run /init when you want Reasonix to create project instructions.

Desktop app

Download the installer for your platform from the official download page, install and launch Reasonix, then configure a provider and model in the app. The CLI commands above are not required for the desktop app.

For advanced CLI usage and configuration, see the CLI reference, Guide, and configuration paths.

Documentation

Star History

Star History Chart

Acknowledgments

A small list of folks whose work has shaped Reasonix the most — the current top 20 contributors by commit count. The full contributor graph is on GitHub.

Contributor Contributor Contributor Contributor
SivanCola esengine ttmouse lifu963
reasonix HUQIANTAO GTC2080 light-front-theory
merge-order-check Li-Charles-One eghrhegpe wufengfan
CVEngineer66 dependabot[bot] lanshi17 SuMuxi66
CnsMaple cyq1017 JesonChou XTLine

Special thanks to Bernardxu123 for designing the project logo and intro video.

Contributors to esengine/DeepSeek-Reasonix



MIT — see LICENSE
Built by the community at esengine/DeepSeek-Reasonix


Support this project

If Reasonix has been useful and you'd like to say thanks, you can. It stays a coffee, not a contract — donations don't buy feature priority or change how issues get triaged.

WeChat Pay QR code

DeepSeek-Reasonix (esengine/DeepSeek-Reasonix)

Searching Database…

Что это такое?Reasonix — это агент для программирования, который решает сложные задачи разработки ПО. Он работает как единый локальный движок, к которому можно обратиться через терминал, десктопное приложение, браузер или редактор по ACP.
Это CLI-инструмент, десктопное приложение или и то и другое?И то и другое, и даже больше: один и тот же локальный движок Reasonix работает в CLI/TUI, в десктопном приложении (на основе Electron) и в расширении для VS Code, которое общается с ним по ACP.
Как установить и запустить?Установите CLI/TUI через npm или Homebrew (macOS) либо скачайте установщик десктопного приложения (.dmg, .exe, .deb) с официальной страницы загрузки. Расширению для VS Code сначала нужно установить CLI, так как оно лишь запускает локальный бэкенд 'reasonix acp'.
Нужно ли мне ставить Go или Node, чтобы пользоваться?Нет, если вы используете готовые бинарники, пакет npm, Homebrew или установщик для десктопа: это самодостаточные статические бинарники. Go 1.26+ (а также Node 24+ и pnpm 10 для оболочки десктопного приложения) нужны только при сборке из исходников.
Работает ли это только с моделями DeepSeek?Нет. DeepSeek — лишь один из готовых пресетов. Можно настроить любой эндпоинт, совместимый с OpenAI, и даже запускать две модели вместе: одну как исполнителя, другую как планировщика.
Какие платформы поддерживаются?macOS (Apple Silicon и Intel), Windows (x64/ARM64) и Linux (x64) — через готовые бинарники или установщики для десктопа.
Как к нему подключить плагины?MCP-серверы добавляют инструменты, промпты и ресурсы, а сайдкары Extension Protocol v1 могут перехватывать события во время работы, добавлять провайдеров и интерфейс, а также поставляться как версионируемые пакеты плагинов.
Как оно настраивается?Всё настраивается через файл reasonix.toml: провайдеры, агент, включённые инструменты и плагины задаются в нём, а не прописываются в коде.
Можно ли использовать в VS Code?Да, официальное расширение для VS Code (SivanLiu.reasonix-agent) запускает ваш локальный бэкенд reasonix ACP и добавляет нативный чат, контекст редактора, подтверждение вызовов инструментов, выбор модели и сессии рабочей области.
Как оно работает с контекстом в долгих сессиях?При запуске оно добавляет небольшую стабильную сводку об окружении, а затем обрезает или удаляет устаревший вывод инструментов до суммаризации. Так контекст остаётся стабильным для кэша в долгих автономных прогонах.
Creator
esengine
Size
219.2 MB
Stars
35.9K
Age
5mo
Commits · 90 Days