# Devo

> Open-source, model-neutral agent desktop/runtime for private, enterprise, and OpenAI-compatible model environments. Supports DeepSeek, Qwen, Kimi, Anthropic-compatible APIs, MCP, and local code search.

- **Type:** MCP server
- **Install:** `agentstack add mcp-7df-lab-devo`
- **Verified:** Pending review
- **Seller:** [7df-lab](https://agentstack.voostack.com/s/7df-lab)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [7df-lab](https://github.com/7df-lab)
- **Source:** https://github.com/7df-lab/devo
- **Website:** https://devo.7df.ai/

## Install

```sh
agentstack add mcp-7df-lab-devo
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

**Devo is an open-source coding agent with a Desktop app, terminal TUI/CLI, and model-neutral Rust runtime for private, enterprise, and OpenAI-compatible model environments. Connect DeepSeek, Qwen, Kimi, Anthropic-compatible APIs, local gateways, or your own model endpoint.**

[](https://github.com/7df-lab/devo/stargazers)
[](https://www.rust-lang.org/)
[](./LICENSE)
[](https://github.com/7df-lab/devo/pulls)
[](https://github.com/7df-lab/devo/actions)
[](https://github.com/7df-lab/devo/releases)
[](https://aur.archlinux.org/packages/devo-bin/)

[English](./README.md) | [简体中文](./README.zh-Hans.md) | [繁體中文](./README.zh-Hant.md) | [日本語](./README.ja.md) | [Русский](./README.ru.md)

[Why Devo](#why-devo) · [Screenshots](#screenshots) · [Features](#features) · [Tested Models](#tested-models) · [Tested Platforms](#tested-platforms) · [Install](#installation) · [Quick Start](#quick-start) · [Docs](#docs)

---

## Screenshots

  

  

## Why Devo

Devo is for teams that need a coding agent outside a single hosted model
ecosystem. It keeps the desktop experience, terminal workflow, model choice,
runtime behavior, and workspace execution under your control.

- **Bring your own model** - Connect OpenAI-compatible Chat Completions,
  OpenAI-compatible Responses, Anthropic Messages, DeepSeek, Qwen, Kimi, or
  private model gateways through provider/model bindings.
- **Works in private and intranet environments** - Run a single local Rust
  binary, support offline installation paths, and point Devo at internal
  endpoints without depending on a hosted agent service.
- **One agent across Desktop and terminal** - Use the Desktop app for visual
  onboarding and daily coding, or the CLI/TUI for terminal-native automation,
  remote shells, and scriptable workflows.
- **Built for agent runtime extensibility** - MCP servers, reusable skills,
  local semantic code search, auditable sessions, permissions, and multi-agent
  flows are runtime features rather than one-off prompts.

## Features

- **Built-in semantic code search** - Runs a local CPU code-embedding model and
  combines dense retrieval with BM25 keyword matching, reducing code-search
  context compared with grep/find-only agent.
- **Model-neutral provider runtime** - Use provider/model bindings for
  OpenAI-compatible, Anthropic-compatible, DeepSeek, Qwen, Kimi, GLM, MiniMax,
  Xiaomi MiMo, OpenRouter, or local endpoints.
- **MCP support** - Connect external tools and context through
  [Model Context Protocol](https://modelcontextprotocol.io/) servers.
- **Skill support** - Package repeatable workflows, instructions, scripts, and
  references as reusable [Agent Skills](https://agentskills.io/).
- **Long-running task support** - Let Devo manage context automatically across
  multi-turn work instead of losing the thread as tasks grow.
- **Multi-agent support** - Split work across specialized agents while keeping
  coordination visible in the session.
- **Plan Mode** - Break larger tasks into clear multi-step plans before
  implementation starts.
- **Parallel tool calls** - Run multiple independent tools in parallel so
  models spend less time waiting and more time making progress.
- **Permissioned tool execution** - Review sensitive tool calls before they
  touch your workspace.
- **Auditable sessions** - Keep model output, tool calls, approvals, token
  usage, and session history inspectable and resumable.
- **Cost and context visibility** - Show input/output tokens, cached tokens, and
  context-window usage where providers expose them.
- **Lightweight Rust runtime** - Built in Rust with low memory overhead and a
  compact local runtime.

## Tested Models

  
  
  
  
  

Devo's built-in model catalog includes tested model definitions for Qwen, Kimi,
MiniMax, GLM, and DeepSeek. Provider endpoints remain configurable through
provider/model bindings.

## Tested Platforms

  
  
  

Devo has been tested on macOS, Linux, Windows, and Kylin OS.

### For Chinese Enterprise Users

  
  

Kylin OS coverage is called out because domestic operating systems are often
part of real deployment requirements in Chinese enterprise environments.
HarmonyOS support is on the roadmap; contributors with HarmonyOS devices are
welcome to build, test, and publish releases for that platform.

## Installation

Devo can be installed in two forms. Pick the Desktop app for a graphical coding
agent workspace, the terminal-native TUI/CLI for shell-first development, or
install both on the same machine.

### Option 1: Desktop App

Start here if you want the graphical Devo experience. Download the latest Devo
Desktop package from [GitHub Releases](https://github.com/7df-lab/devo/releases/latest),
then choose the asset that matches your operating system and architecture:

- **macOS** - download the `devo-desktop-...-mac-...` `.dmg` or `.zip` asset.
- **Windows** - download the `devo-desktop-...-windows-...` `.exe` asset.
- **Linux** - download the `devo-desktop-...-linux-...` `.AppImage`, `.deb`, or
  `.rpm` asset.

**If macOS reports that `Devo.app` is damaged and cannot be opened, this is
expected.** Current macOS Desktop builds are unsigned, so after installing,
run the following command so macOS can launch the app:

```bash
sudo xattr -dr com.apple.quarantine /Applications/Devo.app
```

### Option 2: TUI / CLI

Install the terminal-native `devo` command if you prefer the TUI, want shell
automation, or want to use Devo alongside the Desktop app.

Linux / macOS:

```bash
curl -fsSL https://raw.githubusercontent.com/7df-lab/devo/main/install.sh | sh
```

Windows:

```powershell
irm 'https://raw.githubusercontent.com/7df-lab/devo/main/install.ps1' | iex
```

The online installer places `devo` under the Devo home directory, installs the
`rg` sidecar used for fast repository search, and supports optional setup for
the local model used by `code_search`.

Optional: preinstall the local code_search model

Use this only if you want the Hugging Face model downloaded during installation.

Linux / macOS:

```bash
curl -fsSL https://raw.githubusercontent.com/7df-lab/devo/main/install.sh | sh -s -- --install-code-search-model
```

Windows:

```powershell
$env:DEVO_INSTALL_CODE_SEARCH_MODEL = "1"; irm 'https://raw.githubusercontent.com/7df-lab/devo/main/install.ps1' | iex
```

Upgrade an existing installation to the latest release:

```bash
devo upgrade
```

The upgrade command runs the same platform installer, and the installer prints
the version transition, for example `Version: v0.1.12 -> v0.1.15`.

For air-gapped or intranet installs, see
[Offline Installation](./docs/offline-installation.md).

## Quick Start

Configure a provider, open a repository, and start the TUI:

```bash
cd /path/to/your/repo
devo onboard
```

Useful commands:

```bash
devo                         # start the interactive TUI in the current repo
devo resume 
```

## Configuration

`devo onboard` is the recommended setup path. For manual `config.toml` paths,
provider/model binding fields, and custom model catalog examples, see
[Configuration](./docs/configuration.md).

## Docs

- [Offline Installation](./docs/offline-installation.md)
- [Configuration](./docs/configuration.md)

## FAQ

### What is the project status?

Devo is pre-1.0 and actively developed. It is ready for local evaluation,
experiments, and contributor use; public APIs and configuration may still
change.

### What models are supported?

Built-in model metadata currently covers Qwen, Kimi, MiniMax, GLM, and DeepSeek
families. Any model endpoint that supports OpenAI-compatible Chat Completions,
OpenAI-compatible Responses, or the Anthropic Messages API can be connected through
provider/model bindings.

### Should I use the Desktop app or the TUI/CLI?

Use the Desktop app when you want visual onboarding, session browsing, and a
graphical coding workspace. Use the TUI/CLI when you want terminal-native
automation, remote shell workflows, or a coding agent that stays inside your
existing command-line setup. Both surfaces target the same local Devo runtime.

## Contributing

Contributions are welcome while the project is still early:

- Architecture feedback on the client/server runtime, provider layer, safety
  model, and TUI.
- Documentation and translations.
- Provider, model, and wire API coverage.
- Focused fixes with validation commands and regression tests.

Open an issue or pull request to discuss changes.

## Star History

 
   
   
   
 

## License

This project is licensed under the [MIT License](./LICENSE).

---

**If you find Devo useful, please consider giving it a star.**

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [7df-lab](https://github.com/7df-lab)
- **Source:** [7df-lab/devo](https://github.com/7df-lab/devo)
- **License:** MIT
- **Homepage:** https://devo.7df.ai/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: flagged — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-7df-lab-devo
- Seller: https://agentstack.voostack.com/s/7df-lab
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
