Skip to content

Dodaios is an open-source agent OS for your desktop: it runs your coding agents, browser and apps by voice or chat, on your own machine. Formerly Personal Jarvis.

docs(readme): lead with one hook and move the install commands to the first screen (#617)

Ruben Lütke4dc9e02d702e
diff --git a/README.md b/README.md
index e4b04ff0b9..aa3784a60f 100644
--- a/README.md
+++ b/README.md
@@ -6,8 +6,14 @@
</p>
<p align="center">
- <strong>The open-source AI agent super-app for your desktop.</strong><br />
- Run every coding agent side by side, talk to your computer, and keep a team of AI agents working while you are away.
+ <strong>Run every coding agent side by side, and steer them by voice.</strong><br />
+ Claude Code, Codex, OpenCode and six more share one screen in an open-source desktop app. It is also a voice assistant and a team of AI agents that keeps working while you are away.
+</p>
+
+<p align="center">
+ <a href="#install"><strong>Install in one line</strong></a> ·
+ <a href="https://github.com/Dodaios/Dodaios/releases/latest">Download the desktop app</a><br />
+ <sub>No API key needed if you have a Claude or ChatGPT subscription, or a local model.</sub>
</p>
<p align="center"><sub>Formerly Personal Jarvis.</sub></p>
@@ -20,7 +26,6 @@
</p>
<p align="center">
- <a href="#install">Install</a> ·
<a href="https://dodaios.ai">Website</a> ·
<a href="https://github.com/Dodaios/Dodaios/blob/main/docs/product/start-here/welcome-to-dodaios.md">Docs</a> ·
<a href="https://discord.gg/x7USduHxbc">Discord</a> ·
@@ -33,6 +38,31 @@ https://github.com/user-attachments/assets/42afcb9f-323b-4a57-9b6d-17aa7a2585b2
---
+## Install
+
+**Windows (PowerShell)**
+
+```powershell
+irm https://raw.githubusercontent.com/Dodaios/Dodaios/main/install/install.ps1 | iex
+```
+
+**macOS and Linux**
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/Dodaios/Dodaios/main/install/install.sh | bash
+```
+
+The installer checks for Python 3.11 or newer and Git, offers to install
+whatever is missing, adds the desktop launcher and opens the app. If you run it
+again, it updates your existing installation. You choose your language, wake
+phrase and models inside the app.
+
+You need one API key, a subscription or a local model. A microphone helps for
+voice. You do not need a GPU. Desktop installers and the server setup are under
+[more ways to install](#more-ways-to-install).
+
+## What's inside
+
Dodaios is one desktop app for everything AI can do on a computer. It
has a workspace where several coding agents run side by side, AI agents that
keep their own memory, a voice assistant with a wake word, control of your
@@ -46,14 +76,12 @@ It is free and open source, and it runs on your own machine. You do not need an
account, and there is no cloud of ours between you and your models. It runs on
Windows, macOS and Linux, and as a server without a screen.
-## What's inside
-
| | |
|---|---|
| **Agentic IDE** | Run Claude Code, Codex, OpenCode, Kimi Code, GLM, Grok Build, Antigravity, Cursor CLI and DeepSeek Harness side by side in live terminal panes, as many as your machine can hold. You can brief them by voice. |
+| **Voice** | A wake word, live conversations, dictation into any app, and phone calls. You can interrupt it mid-sentence. |
| **Dodaios Agents** | Build a team of AI agents that stay around. Each one has its own chat, instructions, tools, schedule and memory, and learns from its own work. |
| **Dodaios Verse** | Watch your agents in a 3D world. They walk to their desks, pick up work, and show what they are doing right now. |
-| **Voice** | A wake word, live conversations, dictation into any app, and phone calls. You can interrupt it mid-sentence. |
| **Computer use** | Dodaios clicks, types and reads the screen on your desktop and in your browser. You decide what it may do. |
| **Marketplace** | More than 40 plugins, MCP servers, skills and command-line tools you install with one click, including GitHub, Google Workspace, Notion, Slack, Linear, Spotify and Home Assistant. |
| **Any model** | OpenAI, Anthropic, Gemini, OpenRouter, NVIDIA, Ollama and any local server, or your Claude and ChatGPT subscriptions. You can pick a different one for each task. |
@@ -145,25 +173,10 @@ machine unless you connect a service that needs it.
Read more about [safety and approvals](https://github.com/Dodaios/Dodaios/blob/main/docs/product/privacy-safety-and-support/safety-and-approvals.md)
and [privacy and local data](https://github.com/Dodaios/Dodaios/blob/main/docs/product/privacy-safety-and-support/privacy-and-local-data.md).
-## Install
-
-**Windows (PowerShell)**
-
-```powershell
-irm https://raw.githubusercontent.com/Dodaios/Dodaios/main/install/install.ps1 | iex
-```
-
-**macOS and Linux**
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/Dodaios/Dodaios/main/install/install.sh | bash
-```
+## More ways to install
-The installer checks for Python 3.11 or newer and Git, offers to install
-whatever is missing, adds the desktop launcher and opens the app. If you run it
-again, it updates your existing installation. You choose your language, wake
-phrase and models inside the app.
-Later, open it from the desktop launcher or from a terminal:
+The [one-line installer](#install) is the quickest way in. After it has run,
+open Dodaios from the desktop launcher or from a terminal:
```bash
jarvis # full desktop
@@ -194,9 +207,6 @@ on Windows ARM64, you also need the
[native package index](https://github.com/Dodaios/Dodaios/blob/main/docs/product/start-here/install-dodaios.md#install-the-isolated-pypi-package).
The installer sets that up for you.
-You need one API key, a subscription or a local model. A microphone helps for
-voice. You do not need a GPU.
-
## First steps
1. Finish the short setup in the app. Pick your language, a wake phrase (or a
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 4478a49bcf..c8bde33814 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -6,8 +6,14 @@
</p>
<p align="center">
- <strong>开源的桌面 AI 智能体超级应用。</strong><br />
- 同时驱动所有编程智能体进行 Vibe Coding,用语音和电脑对话,再组建一支在你休息时也持续工作的 AI 智能体团队。
+ <strong>让所有编程智能体并排运行,用语音指挥它们。</strong><br />
+ Claude Code、Codex、OpenCode 等九款编程智能体同屏运行在一款开源桌面应用里。它同时是语音助手,也是一支在你休息时持续工作的 AI 智能体团队。
+</p>
+
+<p align="center">
+ <a href="#安装"><strong>一行命令安装</strong></a> ·
+ <a href="https://github.com/Dodaios/Dodaios/releases/latest">下载桌面版</a><br />
+ <sub>有 Claude 或 ChatGPT 订阅,或者有本地模型,就不需要 API 密钥。</sub>
</p>
<p align="center"><sub>本项目原名 Personal Jarvis。</sub></p>
@@ -20,7 +26,6 @@
</p>
<p align="center">
- <a href="#安装">安装</a> ·
<a href="https://dodaios.ai">官网</a> ·
<a href="https://github.com/Dodaios/Dodaios/blob/main/docs/product/start-here/welcome-to-dodaios.md">文档</a> ·
<a href="https://discord.gg/x7USduHxbc">Discord</a> ·
@@ -33,6 +38,28 @@ https://github.com/user-attachments/assets/42afcb9f-323b-4a57-9b6d-17aa7a2585b2
---
+## 安装
+
+**Windows(PowerShell)**
+
+```powershell
+irm https://raw.githubusercontent.com/Dodaios/Dodaios/main/install/install.ps1 | iex
+```
+
+**macOS 和 Linux**
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/Dodaios/Dodaios/main/install/install.sh | bash
+```
+
+安装程序会检查 Python 3.11+ 和 Git,提示安装缺少的组件,注册桌面启动器并打开应用。
+再次运行即可更新现有安装。语言、唤醒词和模型都在应用内设置。
+
+**你需要**一个 API 密钥、一个订阅或一个本地模型。使用语音时最好有麦克风。不需要 GPU。
+桌面版安装包和服务器部署见[更多安装方式](#更多安装方式)。
+
+## 功能一览
+
Dodaios 不是又一个聊天窗口。它是一款桌面应用,把 AI 在电脑上能做的一切汇集到一处:
多智能体编程工作区、拥有独立记忆的常驻 AI 智能体、带唤醒词的语音助手、桌面与浏览器操控、插件市场,
以及你已经付费的所有模型——云端模型、本地模型或你现有的订阅。
@@ -45,8 +72,6 @@ Dodaios 不是又一个聊天窗口。它是一款桌面应用,把 AI 在电
> **界面语言:** 桌面应用提供简体中文界面。可在首次启动的设置窗口中选择“中文”,
> 也可以随时在“设置 > 语言”中切换。
-## 功能一览
-
| | |
|---|---|
| **Agentic IDE** | 在实时终端窗格中并排运行 Claude Code、Codex、OpenCode、Kimi Code、GLM、Grok Build、Antigravity、Cursor CLI 和 DeepSeek Harness——你的电脑能承载多少就开多少。还能用语音给它们布置任务。 |
@@ -123,22 +148,9 @@ Dodaios 不是又一个聊天窗口。它是一款桌面应用,把 AI 在电
[安全与审批 →](https://github.com/Dodaios/Dodaios/blob/main/docs/product/privacy-safety-and-support/safety-and-approvals.md) ·
[隐私与本地数据 →](https://github.com/Dodaios/Dodaios/blob/main/docs/product/privacy-safety-and-support/privacy-and-local-data.md)
-## 安装
-
-**Windows — PowerShell**
-
-```powershell
-irm https://raw.githubusercontent.com/Dodaios/Dodaios/main/install/install.ps1 | iex
-```
-
-**macOS 和 Linux**
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/Dodaios/Dodaios/main/install/install.sh | bash
-```
+## 更多安装方式
-安装程序会检查 Python 3.11+ 和 Git,提示安装缺少的组件,注册桌面启动器并打开应用。
-再次运行即可更新现有安装。语言、唤醒词和模型都在应用内设置。
+[一行安装命令](#安装)是最快的方式。
**桌面版下载:** [Windows](https://github.com/Dodaios/Dodaios/releases/latest/download/PersonalJarvis-Setup-x64.exe) ·
[macOS(Apple 芯片)](https://github.com/Dodaios/Dodaios/releases/latest/download/PersonalJarvis-macOS-arm64.dmg) ·
@@ -158,8 +170,6 @@ curl -fsSL https://raw.githubusercontent.com/Dodaios/Dodaios/main/install/instal
[原生软件包索引](https://github.com/Dodaios/Dodaios/blob/main/docs/product/start-here/install-dodaios.md#install-the-isolated-pypi-package);
安装程序会自动完成这项配置。
-**你需要**一个 API 密钥、一个订阅或一个本地模型。使用语音时最好有麦克风。不需要 GPU。
-
## 第一步
1. 在应用中完成简短的设置:语言(可选择“中文”)、唤醒词(或键盘快捷键)以及一个模型。