From f3ce9a14c7b7ea482352bc6c8c66bdcd22ba7705 Mon Sep 17 00:00:00 2001
From: morluto <76467478+morluto@users.noreply.github.com>
Date: Sat, 21 Nov 2026 08:38:39 -0500
Subject: [PATCH] docs: streamline the README and expand the RL environment
guide
---
README.md | 72 +++-------
website/evidence/rl-environments.md | 6 +-
website/locales/ar/messages.po | 36 +++++
website/locales/bg/messages.po | 36 +++++
website/locales/de/messages.po | 36 +++++
website/locales/el/messages.po | 36 +++++
website/locales/es/messages.po | 46 ++++++
website/locales/fa/messages.po | 36 +++++
website/locales/fr/messages.po | 36 +++++
website/locales/id/messages.po | 36 +++++
website/locales/it/messages.po | 36 +++++
website/locales/ja/messages.po | 36 +++++
website/locales/ko/messages.po | 36 +++++
website/locales/messages.pot | 136 +++++++++++-------
website/locales/ml/messages.po | 36 +++++
website/locales/pl/messages.po | 36 +++++
website/locales/pt-BR/messages.po | 36 +++++
website/locales/ro/messages.po | 36 +++++
website/locales/ru/messages.po | 36 +++++
website/locales/th/messages.po | 36 +++++
website/locales/tr/messages.po | 36 +++++
website/locales/uk/messages.po | 36 +++++
website/locales/ur-Latn/messages.po | 36 +++++
website/locales/vi/messages.po | 36 +++++
website/locales/zh-CN/messages.po | 40 ++++++
website/locales/zh-TW/messages.po | 36 +++++
.../public/guides/rl-environments/index.html | 21 +++
27 files changed, 971 insertions(+), 106 deletions(-)
diff --git a/README.md b/README.md
index b257e9b22f..321e9e4339 100644
--- a/README.md
+++ b/README.md
@@ -72,7 +72,7 @@ instructions by operating system, agent, and analysis provider.
### Connect your agent (MCP)
-With [Node.js and npm](#what-you-can-analyze) installed, run this from a trusted
+With [Node.js and npm](docs/reference/supported-targets.md) installed, run this from a trusted
directory outside the project you plan to analyze.
```bash
@@ -195,10 +195,7 @@ or build and test an implementation. The CLI uses the same workflows.
REA covers native binaries, JavaScript and Electron apps, websites, .NET
assemblies, Android apps, firmware, and recorded runtime and network activity.
-REA requires Node.js 22.x (>=22.23.4), 24.x (>=24.22.1), or 26.12.1+, plus npm.
-[Supported targets and requirements](docs/reference/supported-targets.md) lists
-the formats REA accepts, what it returns, and any additional tools or host
-requirements.
+[Supported targets and requirements](docs/reference/supported-targets.md)
@@ -207,44 +204,9 @@ and host OS. See [choosing a deep analysis provider](docs/reference/supported-ta
## Build RL environments
-Give an AI agent a local environment to practice tasks such as finding an issue or creating a folder, without running the original app. Use it for reinforcement learning (RL) or to test how well an agent completes tasks.
-
-REA turns recorded API requests and responses into tools the agent can call. The environment uses the recorded data and supports changes only when the recording confirms their effects.
-
-With REA set up in your agent, replace the example URL and folder tasks below with your own:
-
-```text
-Use REA to build an RL environment from my test web app at
-http://127.0.0.1:3000.
-Cover listing, creating, renaming, and deleting folders. You may create and
-remove test folders. Leave existing data unchanged.
-Save it in a folder named my-env. Check which operations work and tell me
-how to run it.
-```
-
-
-Use the command line instead
-
-Use these commands if you already have a file containing the app’s recorded browser requests and responses. Running the result also requires AgentEnv and Docker.
-
-```sh
-rea environment-build ./session.har ./my-env --name my-env --json
-agent-env run ./my-env
-```
-
-
-
-REA exports a runnable environment with a basic test to check that it starts and responds. Use it with your RL framework to define task goals, add reward checks, and run training.
-
-[Build an environment](https://rea.tools/guides/rl-environments/) ·
-[Environment reference](docs/agent-environments.md) ·
-[Watch the demo on X](https://x.com/reatools/status/2112574822584918075?s=20)
-
-### Desktop app environments
-
-REA can also build an environment of a Linux desktop app, which an agent uses through screenshots, the mouse and the keyboard. From a one-line request, such as "Build me a Gnote environment where the agent adds olive oil to the shopping list note", your agent installs the app on a local build computer, writes the task, exports the environment and checks the task in a fresh computer. The machine that builds it needs Linux on amd64 or arm64, Docker and the agentenv framework version the guide pins.
-
-[Set up desktop app environments](docs/desktop-build-computer.md)
+Build a local environment from a recorded web session or a Linux desktop app
+so an agent can practice a task and check its result.
+[Build an RL environment with REA](https://rea.tools/guides/rl-environments/).
## FAQ
@@ -341,6 +303,12 @@ For exact options, prerequisites and result contracts:
Report vulnerabilities through [SECURITY.md](SECURITY.md).
+## Community & Support
+
+- **Discord** — Ask questions and share what you’re investigating. [](https://discord.gg/GkcryMnJDM)
+- **Twitter / X** — Follow [@reatools](https://x.com/reatools) for updates and announcements.
+- **Feedback & Ideas** — Want a new feature or support for a file format? [Open a GitHub issue](https://github.com/morluto/rea/issues) or [join our Discord](https://discord.gg/GkcryMnJDM) and let us know.
+
## Star history
🎉 **400,000 GitHub stars — thank you!**
@@ -355,6 +323,15 @@ Thanks to everyone using REA, reporting bugs, requesting features, testing build
+## Contributing
+
+We'd love your help with REA! [Open an issue](https://github.com/morluto/rea/issues) to
+report a bug or suggest a feature, or [send a pull request](https://github.com/morluto/rea/pulls)
+to improve the code or docs.
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and checks. See the
+[testing guide](docs/development/testing.md) for verification lanes.
+
## Disclaimer
See [DISCLAIMER.md](DISCLAIMER.md) for responsible-use guidance.
@@ -365,15 +342,6 @@ distribution channels, and platforms; each copy retains its applicable licenses.
REA is for lawful research, education, interoperability, software preservation,
and analysis of software you own or are authorized to examine.
-## Contributing
-
-We'd love your help with REA! [Open an issue](https://github.com/morluto/rea/issues) to
-report a bug or suggest a feature, or [send a pull request](https://github.com/morluto/rea/pulls)
-to improve the code or docs.
-
-See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and checks. See the
-[testing guide](docs/development/testing.md) for verification lanes.
-
## License
[MIT](LICENSE)
diff --git a/website/evidence/rl-environments.md b/website/evidence/rl-environments.md
index eea529a7c9..8a109b3f0a 100644
--- a/website/evidence/rl-environments.md
+++ b/website/evidence/rl-environments.md
@@ -2,9 +2,9 @@
The homepage section, showcase-index entry, and
`public/guides/rl-environments/index.html` explain the existing capture, build,
-export, and verification workflow. The short showcase entry links the guide
-and announcement video; the standalone README section retains the setup steps.
-They introduce no new provider or application-support claim.
+export, and verification workflow. The README links to the website guide,
+which includes a Linux desktop example drawn from the
+[desktop build guide](../../docs/desktop-build-computer.md).
The behavior and commands come from the REA
[quickstart](https://github.com/morluto/rea/blob/447907f2808877d3a7de62c382e256f55d08e5ac/docs/agent-environments-quickstart.md),
diff --git a/website/locales/ar/messages.po b/website/locales/ar/messages.po
index c2d328160e..c3054aaf72 100644
--- a/website/locales/ar/messages.po
+++ b/website/locales/ar/messages.po
@@ -14706,6 +14706,42 @@ msgctxt "page:guides/index.html"
msgid "Build an RL environment"
msgstr "دليل إنشاء بيئة"
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:228
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid "{ph0}Build a desktop app environment{ph1}"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:492
+msgctxt "page:guides/rl-environments/index.html"
+msgid "Build a desktop app environment"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:493
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"For a Linux desktop app, describe the task you want an agent to practice. "
+"For example, ask it to build a Gnote environment where the agent adds olive "
+"oil to a shopping list. The agent installs the app on a local build "
+"computer, writes the task, exports the environment, and checks it on a fresh"
+" computer using screenshots, the mouse, and the keyboard."
+msgstr ""
+
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:501
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"The build host needs Linux on amd64 or arm64, Docker, and the pinned "
+"AgentEnv version. Follow the {ph0}desktop build setup guide{ph1} for "
+"installation and readiness checks."
+msgstr ""
+
#: website/public/guides/rl-environments/index.html:111
msgctxt "page:guides/rl-environments/index.html"
msgid "Skip to content"
diff --git a/website/locales/bg/messages.po b/website/locales/bg/messages.po
index cecfa1920c..4ef1bc466d 100644
--- a/website/locales/bg/messages.po
+++ b/website/locales/bg/messages.po
@@ -7752,6 +7752,42 @@ msgctxt "page:guides/native/index.html"
msgid "Back to top"
msgstr ""
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:228
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid "{ph0}Build a desktop app environment{ph1}"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:492
+msgctxt "page:guides/rl-environments/index.html"
+msgid "Build a desktop app environment"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:493
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"For a Linux desktop app, describe the task you want an agent to practice. "
+"For example, ask it to build a Gnote environment where the agent adds olive "
+"oil to a shopping list. The agent installs the app on a local build "
+"computer, writes the task, exports the environment, and checks it on a fresh"
+" computer using screenshots, the mouse, and the keyboard."
+msgstr ""
+
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:501
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"The build host needs Linux on amd64 or arm64, Docker, and the pinned "
+"AgentEnv version. Follow the {ph0}desktop build setup guide{ph1} for "
+"installation and readiness checks."
+msgstr ""
+
#: website/public/guides/rl-environments/index.html:113
msgctxt "page:guides/rl-environments/index.html"
msgid "Skip to content"
diff --git a/website/locales/de/messages.po b/website/locales/de/messages.po
index 63c12148e5..8543aed08c 100644
--- a/website/locales/de/messages.po
+++ b/website/locales/de/messages.po
@@ -15320,6 +15320,42 @@ msgctxt "page:guides/index.html"
msgid "Build an RL environment"
msgstr "Anleitung zum Erstellen einer Umgebung"
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:228
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid "{ph0}Build a desktop app environment{ph1}"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:492
+msgctxt "page:guides/rl-environments/index.html"
+msgid "Build a desktop app environment"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:493
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"For a Linux desktop app, describe the task you want an agent to practice. "
+"For example, ask it to build a Gnote environment where the agent adds olive "
+"oil to a shopping list. The agent installs the app on a local build "
+"computer, writes the task, exports the environment, and checks it on a fresh"
+" computer using screenshots, the mouse, and the keyboard."
+msgstr ""
+
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:501
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"The build host needs Linux on amd64 or arm64, Docker, and the pinned "
+"AgentEnv version. Follow the {ph0}desktop build setup guide{ph1} for "
+"installation and readiness checks."
+msgstr ""
+
#: website/public/guides/rl-environments/index.html:111
msgctxt "page:guides/rl-environments/index.html"
msgid "Skip to content"
diff --git a/website/locales/el/messages.po b/website/locales/el/messages.po
index 20f874910e..a9a8893f3f 100644
--- a/website/locales/el/messages.po
+++ b/website/locales/el/messages.po
@@ -15274,6 +15274,42 @@ msgctxt "page:guides/index.html"
msgid "Build an RL environment"
msgstr "Οδηγός δημιουργίας περιβάλλοντος"
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:228
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid "{ph0}Build a desktop app environment{ph1}"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:492
+msgctxt "page:guides/rl-environments/index.html"
+msgid "Build a desktop app environment"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:493
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"For a Linux desktop app, describe the task you want an agent to practice. "
+"For example, ask it to build a Gnote environment where the agent adds olive "
+"oil to a shopping list. The agent installs the app on a local build "
+"computer, writes the task, exports the environment, and checks it on a fresh"
+" computer using screenshots, the mouse, and the keyboard."
+msgstr ""
+
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:501
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"The build host needs Linux on amd64 or arm64, Docker, and the pinned "
+"AgentEnv version. Follow the {ph0}desktop build setup guide{ph1} for "
+"installation and readiness checks."
+msgstr ""
+
#: website/public/guides/rl-environments/index.html:111
msgctxt "page:guides/rl-environments/index.html"
msgid "Skip to content"
diff --git a/website/locales/es/messages.po b/website/locales/es/messages.po
index 4dfabdb1ab..8bea42ed22 100644
--- a/website/locales/es/messages.po
+++ b/website/locales/es/messages.po
@@ -15202,6 +15202,52 @@ msgctxt "page:guides/index.html"
msgid "Build an RL environment"
msgstr "Guía para crear un entorno"
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:228
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid "{ph0}Build a desktop app environment{ph1}"
+msgstr "{ph0}Crear un entorno de una aplicación de escritorio{ph1}"
+
+#: website/public/guides/rl-environments/index.html:492
+msgctxt "page:guides/rl-environments/index.html"
+msgid "Build a desktop app environment"
+msgstr "Crear un entorno de una aplicación de escritorio"
+
+#: website/public/guides/rl-environments/index.html:493
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"For a Linux desktop app, describe the task you want an agent to practice. "
+"For example, ask it to build a Gnote environment where the agent adds olive "
+"oil to a shopping list. The agent installs the app on a local build "
+"computer, writes the task, exports the environment, and checks it on a fresh"
+" computer using screenshots, the mouse, and the keyboard."
+msgstr ""
+"Para una aplicación de escritorio de Linux, describe la tarea que quieres "
+"que practique el agente. Por ejemplo, pídele que cree un entorno de Gnote en"
+" el que añada aceite de oliva a una lista de la compra. El agente instala la"
+" aplicación en un equipo de compilación local, define la tarea, exporta el "
+"entorno y lo comprueba en un equipo nuevo mediante capturas de pantalla, el "
+"ratón y el teclado."
+
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:501
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"The build host needs Linux on amd64 or arm64, Docker, and the pinned "
+"AgentEnv version. Follow the {ph0}desktop build setup guide{ph1} for "
+"installation and readiness checks."
+msgstr ""
+"El equipo de compilación necesita Linux en amd64 o arm64, Docker y la "
+"versión especificada de AgentEnv. Sigue la {ph0}guía de configuración del "
+"equipo de compilación{ph1} para instalar los requisitos y comprobar que el "
+"equipo está listo."
+
#: website/public/guides/rl-environments/index.html:111
msgctxt "page:guides/rl-environments/index.html"
msgid "Skip to content"
diff --git a/website/locales/fa/messages.po b/website/locales/fa/messages.po
index d30d30f3d7..f9202a9077 100644
--- a/website/locales/fa/messages.po
+++ b/website/locales/fa/messages.po
@@ -14858,6 +14858,42 @@ msgctxt "page:guides/index.html"
msgid "Build an RL environment"
msgstr "راهنمای ساخت محیط"
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:228
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid "{ph0}Build a desktop app environment{ph1}"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:492
+msgctxt "page:guides/rl-environments/index.html"
+msgid "Build a desktop app environment"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:493
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"For a Linux desktop app, describe the task you want an agent to practice. "
+"For example, ask it to build a Gnote environment where the agent adds olive "
+"oil to a shopping list. The agent installs the app on a local build "
+"computer, writes the task, exports the environment, and checks it on a fresh"
+" computer using screenshots, the mouse, and the keyboard."
+msgstr ""
+
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:501
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"The build host needs Linux on amd64 or arm64, Docker, and the pinned "
+"AgentEnv version. Follow the {ph0}desktop build setup guide{ph1} for "
+"installation and readiness checks."
+msgstr ""
+
#: website/public/guides/rl-environments/index.html:111
msgctxt "page:guides/rl-environments/index.html"
msgid "Skip to content"
diff --git a/website/locales/fr/messages.po b/website/locales/fr/messages.po
index aec6a79509..d7f1bee649 100644
--- a/website/locales/fr/messages.po
+++ b/website/locales/fr/messages.po
@@ -15248,6 +15248,42 @@ msgctxt "page:guides/index.html"
msgid "Build an RL environment"
msgstr "Guide de création d’un environnement"
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:228
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid "{ph0}Build a desktop app environment{ph1}"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:492
+msgctxt "page:guides/rl-environments/index.html"
+msgid "Build a desktop app environment"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:493
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"For a Linux desktop app, describe the task you want an agent to practice. "
+"For example, ask it to build a Gnote environment where the agent adds olive "
+"oil to a shopping list. The agent installs the app on a local build "
+"computer, writes the task, exports the environment, and checks it on a fresh"
+" computer using screenshots, the mouse, and the keyboard."
+msgstr ""
+
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:501
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"The build host needs Linux on amd64 or arm64, Docker, and the pinned "
+"AgentEnv version. Follow the {ph0}desktop build setup guide{ph1} for "
+"installation and readiness checks."
+msgstr ""
+
#: website/public/guides/rl-environments/index.html:111
msgctxt "page:guides/rl-environments/index.html"
msgid "Skip to content"
diff --git a/website/locales/id/messages.po b/website/locales/id/messages.po
index 8df8a4155e..fd944d37aa 100644
--- a/website/locales/id/messages.po
+++ b/website/locales/id/messages.po
@@ -15086,6 +15086,42 @@ msgctxt "page:guides/index.html"
msgid "Build an RL environment"
msgstr "Panduan membangun lingkungan"
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:228
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid "{ph0}Build a desktop app environment{ph1}"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:492
+msgctxt "page:guides/rl-environments/index.html"
+msgid "Build a desktop app environment"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:493
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"For a Linux desktop app, describe the task you want an agent to practice. "
+"For example, ask it to build a Gnote environment where the agent adds olive "
+"oil to a shopping list. The agent installs the app on a local build "
+"computer, writes the task, exports the environment, and checks it on a fresh"
+" computer using screenshots, the mouse, and the keyboard."
+msgstr ""
+
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:501
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"The build host needs Linux on amd64 or arm64, Docker, and the pinned "
+"AgentEnv version. Follow the {ph0}desktop build setup guide{ph1} for "
+"installation and readiness checks."
+msgstr ""
+
#: website/public/guides/rl-environments/index.html:111
msgctxt "page:guides/rl-environments/index.html"
msgid "Skip to content"
diff --git a/website/locales/it/messages.po b/website/locales/it/messages.po
index 43fba89297..20e02b6754 100644
--- a/website/locales/it/messages.po
+++ b/website/locales/it/messages.po
@@ -15151,6 +15151,42 @@ msgctxt "page:guides/index.html"
msgid "Build an RL environment"
msgstr "Guida alla creazione di un ambiente"
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:228
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid "{ph0}Build a desktop app environment{ph1}"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:492
+msgctxt "page:guides/rl-environments/index.html"
+msgid "Build a desktop app environment"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:493
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"For a Linux desktop app, describe the task you want an agent to practice. "
+"For example, ask it to build a Gnote environment where the agent adds olive "
+"oil to a shopping list. The agent installs the app on a local build "
+"computer, writes the task, exports the environment, and checks it on a fresh"
+" computer using screenshots, the mouse, and the keyboard."
+msgstr ""
+
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:501
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"The build host needs Linux on amd64 or arm64, Docker, and the pinned "
+"AgentEnv version. Follow the {ph0}desktop build setup guide{ph1} for "
+"installation and readiness checks."
+msgstr ""
+
#: website/public/guides/rl-environments/index.html:111
msgctxt "page:guides/rl-environments/index.html"
msgid "Skip to content"
diff --git a/website/locales/ja/messages.po b/website/locales/ja/messages.po
index c3ad0f9006..e802bfbcbb 100644
--- a/website/locales/ja/messages.po
+++ b/website/locales/ja/messages.po
@@ -14000,6 +14000,42 @@ msgctxt "page:guides/index.html"
msgid "Build an RL environment"
msgstr "環境構築ガイド"
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:228
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid "{ph0}Build a desktop app environment{ph1}"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:492
+msgctxt "page:guides/rl-environments/index.html"
+msgid "Build a desktop app environment"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:493
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"For a Linux desktop app, describe the task you want an agent to practice. "
+"For example, ask it to build a Gnote environment where the agent adds olive "
+"oil to a shopping list. The agent installs the app on a local build "
+"computer, writes the task, exports the environment, and checks it on a fresh"
+" computer using screenshots, the mouse, and the keyboard."
+msgstr ""
+
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:501
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"The build host needs Linux on amd64 or arm64, Docker, and the pinned "
+"AgentEnv version. Follow the {ph0}desktop build setup guide{ph1} for "
+"installation and readiness checks."
+msgstr ""
+
#: website/public/guides/rl-environments/index.html:111
msgctxt "page:guides/rl-environments/index.html"
msgid "Skip to content"
diff --git a/website/locales/ko/messages.po b/website/locales/ko/messages.po
index 2f8c33da9e..fcdb53511e 100644
--- a/website/locales/ko/messages.po
+++ b/website/locales/ko/messages.po
@@ -14069,6 +14069,42 @@ msgctxt "page:guides/index.html"
msgid "Build an RL environment"
msgstr "환경 만들기 가이드"
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:228
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid "{ph0}Build a desktop app environment{ph1}"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:492
+msgctxt "page:guides/rl-environments/index.html"
+msgid "Build a desktop app environment"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:493
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"For a Linux desktop app, describe the task you want an agent to practice. "
+"For example, ask it to build a Gnote environment where the agent adds olive "
+"oil to a shopping list. The agent installs the app on a local build "
+"computer, writes the task, exports the environment, and checks it on a fresh"
+" computer using screenshots, the mouse, and the keyboard."
+msgstr ""
+
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:501
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"The build host needs Linux on amd64 or arm64, Docker, and the pinned "
+"AgentEnv version. Follow the {ph0}desktop build setup guide{ph1} for "
+"installation and readiness checks."
+msgstr ""
+
#: website/public/guides/rl-environments/index.html:111
msgctxt "page:guides/rl-environments/index.html"
msgid "Skip to content"
diff --git a/website/locales/messages.pot b/website/locales/messages.pot
index cb48f60396..6b41a5a3c2 100644
--- a/website/locales/messages.pot
+++ b/website/locales/messages.pot
@@ -172,7 +172,7 @@ msgstr ""
#: website/public/guides/browser/index.html:509 website/public/guides/index.html:303
#: website/public/guides/javascript/index.html:513
#: website/public/guides/native/index.html:514
-#: website/public/guides/rl-environments/index.html:500 website/public/index.html:1305
+#: website/public/guides/rl-environments/index.html:521 website/public/index.html:1305
#: website/public/showcase/aegis/index.html:817
#: website/public/showcase/ctf/index.html:779
#: website/public/showcase/dx-ball/index.html:787 website/public/showcase/index.html:339
@@ -192,7 +192,7 @@ msgstr ""
#: website/public/guides/browser/index.html:510 website/public/guides/index.html:304
#: website/public/guides/javascript/index.html:514
#: website/public/guides/native/index.html:515
-#: website/public/guides/rl-environments/index.html:501 website/public/index.html:1306
+#: website/public/guides/rl-environments/index.html:522 website/public/index.html:1306
#: website/public/showcase/aegis/index.html:818
#: website/public/showcase/ctf/index.html:780
#: website/public/showcase/dx-ball/index.html:788 website/public/showcase/index.html:340
@@ -212,7 +212,7 @@ msgstr ""
#: website/public/guides/browser/index.html:511 website/public/guides/index.html:305
#: website/public/guides/javascript/index.html:515
#: website/public/guides/native/index.html:516
-#: website/public/guides/rl-environments/index.html:502 website/public/index.html:1307
+#: website/public/guides/rl-environments/index.html:523 website/public/index.html:1307
#: website/public/showcase/aegis/index.html:819
#: website/public/showcase/ctf/index.html:781
#: website/public/showcase/dx-ball/index.html:789 website/public/showcase/index.html:341
@@ -232,7 +232,7 @@ msgstr ""
#: website/public/guides/browser/index.html:512 website/public/guides/index.html:306
#: website/public/guides/javascript/index.html:516
#: website/public/guides/native/index.html:517
-#: website/public/guides/rl-environments/index.html:503 website/public/index.html:1308
+#: website/public/guides/rl-environments/index.html:524 website/public/index.html:1308
#: website/public/showcase/aegis/index.html:820
#: website/public/showcase/ctf/index.html:782
#: website/public/showcase/dx-ball/index.html:790 website/public/showcase/index.html:342
@@ -252,7 +252,7 @@ msgstr ""
#: website/public/guides/browser/index.html:513 website/public/guides/index.html:307
#: website/public/guides/javascript/index.html:517
#: website/public/guides/native/index.html:518
-#: website/public/guides/rl-environments/index.html:504 website/public/index.html:1309
+#: website/public/guides/rl-environments/index.html:525 website/public/index.html:1309
#: website/public/showcase/aegis/index.html:821
#: website/public/showcase/ctf/index.html:783
#: website/public/showcase/dx-ball/index.html:791 website/public/showcase/index.html:343
@@ -274,7 +274,7 @@ msgstr ""
#: website/public/guides/browser/index.html:518 website/public/guides/index.html:312
#: website/public/guides/javascript/index.html:522
#: website/public/guides/native/index.html:523
-#: website/public/guides/rl-environments/index.html:509 website/public/index.html:1314
+#: website/public/guides/rl-environments/index.html:530 website/public/index.html:1314
#: website/public/showcase/aegis/index.html:826
#: website/public/showcase/ctf/index.html:788
#: website/public/showcase/dx-ball/index.html:796 website/public/showcase/index.html:348
@@ -7588,12 +7588,20 @@ msgctxt "page:guides/rl-environments/index.html"
msgid "{ph0}Check what works{ph1}"
msgstr ""
-#: website/public/guides/rl-environments/index.html:232
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:228
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid "{ph0}Build a desktop app environment{ph1}"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:233
msgctxt "page:guides/rl-environments/index.html"
msgid "What REA builds"
msgstr ""
-#: website/public/guides/rl-environments/index.html:233
+#: website/public/guides/rl-environments/index.html:234
msgctxt "page:guides/rl-environments/index.html"
msgid ""
"An agent can practice finding an issue, creating a folder, or editing a record without"
@@ -7607,7 +7615,7 @@ msgstr ""
#. {ph3}:
#. {ph4}:
#. {ph5}:
-#: website/public/guides/rl-environments/index.html:241
+#: website/public/guides/rl-environments/index.html:242
#, python-brace-format
msgctxt "page:guides/rl-environments/index.html"
msgid ""
@@ -7621,7 +7629,7 @@ msgstr ""
#. {ph3}:
#. {ph4}:
#. {ph5}:
-#: website/public/guides/rl-environments/index.html:249
+#: website/public/guides/rl-environments/index.html:250
#, python-brace-format
msgctxt "page:guides/rl-environments/index.html"
msgid ""
@@ -7635,7 +7643,7 @@ msgstr ""
#. {ph3}:
#. {ph4}:
#. {ph5}:
-#: website/public/guides/rl-environments/index.html:257
+#: website/public/guides/rl-environments/index.html:258
#, python-brace-format
msgctxt "page:guides/rl-environments/index.html"
msgid ""
@@ -7643,21 +7651,21 @@ msgid ""
"task goals and reward checks for evaluation or RL training.{ph5}"
msgstr ""
-#: website/public/guides/rl-environments/index.html:267
+#: website/public/guides/rl-environments/index.html:268
msgctxt "page:guides/rl-environments/index.html"
msgid ""
"The recording determines which operations the environment can support. Changes are "
"supported when the recording confirms their effects."
msgstr ""
-#: website/public/guides/rl-environments/index.html:275
+#: website/public/guides/rl-environments/index.html:276
msgctxt "page:guides/rl-environments/index.html"
msgid "Before you start"
msgstr ""
#. {ph0}:
#. {ph1}:
-#: website/public/guides/rl-environments/index.html:276
+#: website/public/guides/rl-environments/index.html:277
#, python-brace-format
msgctxt "page:guides/rl-environments/index.html"
msgid ""
@@ -7669,7 +7677,7 @@ msgstr ""
#. {ph0}:
#. {ph1}:
#. {ph2}: 0.9.1334
-#: website/public/guides/rl-environments/index.html:283
+#: website/public/guides/rl-environments/index.html:284
#, python-brace-format
msgctxt "page:guides/rl-environments/index.html"
msgid ""
@@ -7677,12 +7685,12 @@ msgid ""
"Docker. REA's compatibility check uses AgentEnv version {ph2} with Python 3.12."
msgstr ""
-#: website/public/guides/rl-environments/index.html:293
+#: website/public/guides/rl-environments/index.html:294
msgctxt "page:guides/rl-environments/index.html"
msgid "Record and build with your agent"
msgstr ""
-#: website/public/guides/rl-environments/index.html:294
+#: website/public/guides/rl-environments/index.html:295
msgctxt "page:guides/rl-environments/index.html"
msgid ""
"Tell your agent which app and operations to cover. For an app with folders, adapt this"
@@ -7697,17 +7705,17 @@ msgstr ""
#. {ph5}:
#. {ph6}:
#. {ph7}:
-#: website/public/guides/rl-environments/index.html:300
-#: website/public/guides/rl-environments/index.html:417
+#: website/public/guides/rl-environments/index.html:301
+#: website/public/guides/rl-environments/index.html:418
#, python-brace-format
msgctxt "page:guides/rl-environments/index.html"
msgid "{ph0}{ph1}{ph2}{ph3}{ph4}{ph5}{ph6}{ph7}Your coding agent"
msgstr ""
-#: website/public/guides/rl-environments/index.html:304
-#: website/public/guides/rl-environments/index.html:349
-#: website/public/guides/rl-environments/index.html:384
-#: website/public/guides/rl-environments/index.html:421
+#: website/public/guides/rl-environments/index.html:305
+#: website/public/guides/rl-environments/index.html:350
+#: website/public/guides/rl-environments/index.html:385
+#: website/public/guides/rl-environments/index.html:422
msgctxt "page:guides/rl-environments/index.html"
msgid "Copy"
msgstr ""
@@ -7722,7 +7730,7 @@ msgstr ""
#. {ph7}:
#. {ph8}:
#. {ph9}:
-#: website/public/guides/rl-environments/index.html:313
+#: website/public/guides/rl-environments/index.html:314
#, python-brace-format
msgctxt "page:guides/rl-environments/index.html"
msgid ""
@@ -7734,7 +7742,7 @@ msgid ""
msgstr ""
#. {ph0}: APP_PASSWORD
-#: website/public/guides/rl-environments/index.html:328
+#: website/public/guides/rl-environments/index.html:329
#, python-brace-format
msgctxt "page:guides/rl-environments/index.html"
msgid ""
@@ -7744,7 +7752,7 @@ msgstr ""
#. {ph0}:
#. {ph1}:
-#: website/public/guides/rl-environments/index.html:333
+#: website/public/guides/rl-environments/index.html:334
#, python-brace-format
msgctxt "page:guides/rl-environments/index.html"
msgid ""
@@ -7753,12 +7761,12 @@ msgid ""
"environment{ph1}."
msgstr ""
-#: website/public/guides/rl-environments/index.html:340
+#: website/public/guides/rl-environments/index.html:341
msgctxt "page:guides/rl-environments/index.html"
msgid "Or use a saved recording"
msgstr ""
-#: website/public/guides/rl-environments/index.html:341
+#: website/public/guides/rl-environments/index.html:342
msgctxt "page:guides/rl-environments/index.html"
msgid ""
"A HAR file records a browser's network requests and responses. Export one with API "
@@ -7766,14 +7774,14 @@ msgid ""
"folder:"
msgstr ""
-#: website/public/guides/rl-environments/index.html:348
+#: website/public/guides/rl-environments/index.html:349
msgctxt "page:guides/rl-environments/index.html"
msgid "Build the environment"
msgstr ""
#. {ph0}: capture-browser-scenario
#. {ph1}: --dry-run
-#: website/public/guides/rl-environments/index.html:360
+#: website/public/guides/rl-environments/index.html:361
#, python-brace-format
msgctxt "page:guides/rl-environments/index.html"
msgid ""
@@ -7783,7 +7791,7 @@ msgid ""
"without writing files."
msgstr ""
-#: website/public/guides/rl-environments/index.html:368
+#: website/public/guides/rl-environments/index.html:369
msgctxt "page:guides/rl-environments/index.html"
msgid ""
"The report lists read operations, supported changes, and operations withheld because "
@@ -7791,31 +7799,31 @@ msgid ""
"and a hint about what to record next."
msgstr ""
-#: website/public/guides/rl-environments/index.html:376
+#: website/public/guides/rl-environments/index.html:377
msgctxt "page:guides/rl-environments/index.html"
msgid "Run the environment"
msgstr ""
-#: website/public/guides/rl-environments/index.html:377
+#: website/public/guides/rl-environments/index.html:378
msgctxt "page:guides/rl-environments/index.html"
msgid ""
"Whether your agent exported the folder or you built it from a recording, run it with "
"AgentEnv:"
msgstr ""
-#: website/public/guides/rl-environments/index.html:383
+#: website/public/guides/rl-environments/index.html:384
msgctxt "page:guides/rl-environments/index.html"
msgid "Run the environment test"
msgstr ""
-#: website/public/guides/rl-environments/index.html:395
+#: website/public/guides/rl-environments/index.html:396
msgctxt "page:guides/rl-environments/index.html"
msgid ""
"Use the path your agent reported if it differs. The first run builds the container "
"image and needs access to its image and package sources."
msgstr ""
-#: website/public/guides/rl-environments/index.html:400
+#: website/public/guides/rl-environments/index.html:401
msgctxt "page:guides/rl-environments/index.html"
msgid ""
"The included smoke task is a basic test. It checks the tool count and, when a suitable"
@@ -7823,12 +7831,12 @@ msgid ""
"environment starts and responds in that setup."
msgstr ""
-#: website/public/guides/rl-environments/index.html:408
+#: website/public/guides/rl-environments/index.html:409
msgctxt "page:guides/rl-environments/index.html"
msgid "Add tasks and reward checks"
msgstr ""
-#: website/public/guides/rl-environments/index.html:409
+#: website/public/guides/rl-environments/index.html:410
msgctxt "page:guides/rl-environments/index.html"
msgid ""
"Use the environment with your RL framework to define goals, score results, and run "
@@ -7842,7 +7850,7 @@ msgstr ""
#. {ph3}:
#. {ph4}:
#. {ph5}:
-#: website/public/guides/rl-environments/index.html:430
+#: website/public/guides/rl-environments/index.html:431
#, python-brace-format
msgctxt "page:guides/rl-environments/index.html"
msgid ""
@@ -7853,7 +7861,7 @@ msgid ""
"formats.{ph3}{ph4}{ph5}"
msgstr ""
-#: website/public/guides/rl-environments/index.html:442
+#: website/public/guides/rl-environments/index.html:443
msgctxt "page:guides/rl-environments/index.html"
msgid ""
"Example prompt for an environment that supports folder creation. A task that changes "
@@ -7863,7 +7871,7 @@ msgstr ""
#. {ph0}:
#. {ph1}:
-#: website/public/guides/rl-environments/index.html:447
+#: website/public/guides/rl-environments/index.html:448
#, python-brace-format
msgctxt "page:guides/rl-environments/index.html"
msgid ""
@@ -7872,12 +7880,12 @@ msgid ""
"tasks, verifiers, and agent connections."
msgstr ""
-#: website/public/guides/rl-environments/index.html:457
+#: website/public/guides/rl-environments/index.html:458
msgctxt "page:guides/rl-environments/index.html"
msgid "Check what works"
msgstr ""
-#: website/public/guides/rl-environments/index.html:458
+#: website/public/guides/rl-environments/index.html:459
msgctxt "page:guides/rl-environments/index.html"
msgid ""
"For changes to be supported, record the results as well as the action: read an item, "
@@ -7886,7 +7894,7 @@ msgid ""
msgstr ""
#. {ph0}: environment-compare
-#: website/public/guides/rl-environments/index.html:464
+#: website/public/guides/rl-environments/index.html:465
#, python-brace-format
msgctxt "page:guides/rl-environments/index.html"
msgid ""
@@ -7895,7 +7903,7 @@ msgid ""
"against the app from the same starting data."
msgstr ""
-#: website/public/guides/rl-environments/index.html:470
+#: website/public/guides/rl-environments/index.html:471
msgctxt "page:guides/rl-environments/index.html"
msgid ""
"Before sharing the folder, review its retained response bodies and local paths. Custom"
@@ -7909,7 +7917,7 @@ msgstr ""
#. {ph2}:
#. {ph3}:
-#: website/public/guides/rl-environments/index.html:476
+#: website/public/guides/rl-environments/index.html:477
#, python-brace-format
msgctxt "page:guides/rl-environments/index.html"
msgid ""
@@ -7918,32 +7926,58 @@ msgid ""
"state controls, and limits."
msgstr ""
+#: website/public/guides/rl-environments/index.html:492
+msgctxt "page:guides/rl-environments/index.html"
+msgid "Build a desktop app environment"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:493
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"For a Linux desktop app, describe the task you want an agent to practice. For example,"
+" ask it to build a Gnote environment where the agent adds olive oil to a shopping "
+"list. The agent installs the app on a local build computer, writes the task, exports "
+"the environment, and checks it on a fresh computer using screenshots, the mouse, and "
+"the keyboard."
+msgstr ""
+
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:501
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"The build host needs Linux on amd64 or arm64, Docker, and the pinned AgentEnv version."
+" Follow the {ph0}desktop build setup guide{ph1} for installation and readiness checks."
+msgstr ""
+
#: website/public/guides/rl-environments/index.html:6
msgctxt "page:guides/rl-environments/index.html"
msgid "Build RL environments with REA"
msgstr ""
-#: website/public/guides/rl-environments/index.html:304
+#: website/public/guides/rl-environments/index.html:305
msgctxt "page:guides/rl-environments/index.html"
msgid "Copy environment prompt"
msgstr ""
-#: website/public/guides/rl-environments/index.html:349
+#: website/public/guides/rl-environments/index.html:350
msgctxt "page:guides/rl-environments/index.html"
msgid "Copy environment build command"
msgstr ""
-#: website/public/guides/rl-environments/index.html:384
+#: website/public/guides/rl-environments/index.html:385
msgctxt "page:guides/rl-environments/index.html"
msgid "Copy environment run command"
msgstr ""
-#: website/public/guides/rl-environments/index.html:421
+#: website/public/guides/rl-environments/index.html:422
msgctxt "page:guides/rl-environments/index.html"
msgid "Copy task prompt"
msgstr ""
-#: website/public/guides/rl-environments/index.html:509
+#: website/public/guides/rl-environments/index.html:530
msgctxt "page:guides/rl-environments/index.html"
msgid "Back to top"
msgstr ""
diff --git a/website/locales/ml/messages.po b/website/locales/ml/messages.po
index 40001ca172..5e92d9474d 100644
--- a/website/locales/ml/messages.po
+++ b/website/locales/ml/messages.po
@@ -13159,6 +13159,42 @@ msgctxt "page:guides/index.html"
msgid "Build an RL environment"
msgstr "പരിതസ്ഥിതി നിർമ്മാണ മാർഗ്ഗദർശി"
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:228
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid "{ph0}Build a desktop app environment{ph1}"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:492
+msgctxt "page:guides/rl-environments/index.html"
+msgid "Build a desktop app environment"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:493
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"For a Linux desktop app, describe the task you want an agent to practice. "
+"For example, ask it to build a Gnote environment where the agent adds olive "
+"oil to a shopping list. The agent installs the app on a local build "
+"computer, writes the task, exports the environment, and checks it on a fresh"
+" computer using screenshots, the mouse, and the keyboard."
+msgstr ""
+
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:501
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"The build host needs Linux on amd64 or arm64, Docker, and the pinned "
+"AgentEnv version. Follow the {ph0}desktop build setup guide{ph1} for "
+"installation and readiness checks."
+msgstr ""
+
#: website/public/guides/rl-environments/index.html:111
msgctxt "page:guides/rl-environments/index.html"
msgid "Skip to content"
diff --git a/website/locales/pl/messages.po b/website/locales/pl/messages.po
index b1b26cfa51..3a522ab918 100644
--- a/website/locales/pl/messages.po
+++ b/website/locales/pl/messages.po
@@ -15043,6 +15043,42 @@ msgctxt "page:guides/index.html"
msgid "Build an RL environment"
msgstr "Przewodnik tworzenia środowiska"
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:228
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid "{ph0}Build a desktop app environment{ph1}"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:492
+msgctxt "page:guides/rl-environments/index.html"
+msgid "Build a desktop app environment"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:493
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"For a Linux desktop app, describe the task you want an agent to practice. "
+"For example, ask it to build a Gnote environment where the agent adds olive "
+"oil to a shopping list. The agent installs the app on a local build "
+"computer, writes the task, exports the environment, and checks it on a fresh"
+" computer using screenshots, the mouse, and the keyboard."
+msgstr ""
+
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:501
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"The build host needs Linux on amd64 or arm64, Docker, and the pinned "
+"AgentEnv version. Follow the {ph0}desktop build setup guide{ph1} for "
+"installation and readiness checks."
+msgstr ""
+
#: website/public/guides/rl-environments/index.html:111
msgctxt "page:guides/rl-environments/index.html"
msgid "Skip to content"
diff --git a/website/locales/pt-BR/messages.po b/website/locales/pt-BR/messages.po
index cb74ee5fe6..5ab5ab9b98 100644
--- a/website/locales/pt-BR/messages.po
+++ b/website/locales/pt-BR/messages.po
@@ -15121,6 +15121,42 @@ msgctxt "page:guides/index.html"
msgid "Build an RL environment"
msgstr "Guia para criar um ambiente"
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:228
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid "{ph0}Build a desktop app environment{ph1}"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:492
+msgctxt "page:guides/rl-environments/index.html"
+msgid "Build a desktop app environment"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:493
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"For a Linux desktop app, describe the task you want an agent to practice. "
+"For example, ask it to build a Gnote environment where the agent adds olive "
+"oil to a shopping list. The agent installs the app on a local build "
+"computer, writes the task, exports the environment, and checks it on a fresh"
+" computer using screenshots, the mouse, and the keyboard."
+msgstr ""
+
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:501
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"The build host needs Linux on amd64 or arm64, Docker, and the pinned "
+"AgentEnv version. Follow the {ph0}desktop build setup guide{ph1} for "
+"installation and readiness checks."
+msgstr ""
+
#: website/public/guides/rl-environments/index.html:111
msgctxt "page:guides/rl-environments/index.html"
msgid "Skip to content"
diff --git a/website/locales/ro/messages.po b/website/locales/ro/messages.po
index 6fdec320e6..6612dad7ab 100644
--- a/website/locales/ro/messages.po
+++ b/website/locales/ro/messages.po
@@ -13161,6 +13161,42 @@ msgctxt "page:guides/index.html"
msgid "Build an RL environment"
msgstr "Ghid pentru construirea unui mediu"
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:228
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid "{ph0}Build a desktop app environment{ph1}"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:492
+msgctxt "page:guides/rl-environments/index.html"
+msgid "Build a desktop app environment"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:493
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"For a Linux desktop app, describe the task you want an agent to practice. "
+"For example, ask it to build a Gnote environment where the agent adds olive "
+"oil to a shopping list. The agent installs the app on a local build "
+"computer, writes the task, exports the environment, and checks it on a fresh"
+" computer using screenshots, the mouse, and the keyboard."
+msgstr ""
+
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:501
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"The build host needs Linux on amd64 or arm64, Docker, and the pinned "
+"AgentEnv version. Follow the {ph0}desktop build setup guide{ph1} for "
+"installation and readiness checks."
+msgstr ""
+
#: website/public/guides/rl-environments/index.html:111
msgctxt "page:guides/rl-environments/index.html"
msgid "Skip to content"
diff --git a/website/locales/ru/messages.po b/website/locales/ru/messages.po
index 496153b0d0..d9fb4fdc9f 100644
--- a/website/locales/ru/messages.po
+++ b/website/locales/ru/messages.po
@@ -15156,6 +15156,42 @@ msgctxt "page:guides/index.html"
msgid "Build an RL environment"
msgstr "Руководство по созданию окружения"
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:228
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid "{ph0}Build a desktop app environment{ph1}"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:492
+msgctxt "page:guides/rl-environments/index.html"
+msgid "Build a desktop app environment"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:493
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"For a Linux desktop app, describe the task you want an agent to practice. "
+"For example, ask it to build a Gnote environment where the agent adds olive "
+"oil to a shopping list. The agent installs the app on a local build "
+"computer, writes the task, exports the environment, and checks it on a fresh"
+" computer using screenshots, the mouse, and the keyboard."
+msgstr ""
+
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:501
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"The build host needs Linux on amd64 or arm64, Docker, and the pinned "
+"AgentEnv version. Follow the {ph0}desktop build setup guide{ph1} for "
+"installation and readiness checks."
+msgstr ""
+
#: website/public/guides/rl-environments/index.html:111
msgctxt "page:guides/rl-environments/index.html"
msgid "Skip to content"
diff --git a/website/locales/th/messages.po b/website/locales/th/messages.po
index 3e700c9d3a..cd2753e9e9 100644
--- a/website/locales/th/messages.po
+++ b/website/locales/th/messages.po
@@ -14758,6 +14758,42 @@ msgctxt "page:guides/index.html"
msgid "Build an RL environment"
msgstr "คู่มือสร้างสภาพแวดล้อม"
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:228
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid "{ph0}Build a desktop app environment{ph1}"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:492
+msgctxt "page:guides/rl-environments/index.html"
+msgid "Build a desktop app environment"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:493
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"For a Linux desktop app, describe the task you want an agent to practice. "
+"For example, ask it to build a Gnote environment where the agent adds olive "
+"oil to a shopping list. The agent installs the app on a local build "
+"computer, writes the task, exports the environment, and checks it on a fresh"
+" computer using screenshots, the mouse, and the keyboard."
+msgstr ""
+
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:501
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"The build host needs Linux on amd64 or arm64, Docker, and the pinned "
+"AgentEnv version. Follow the {ph0}desktop build setup guide{ph1} for "
+"installation and readiness checks."
+msgstr ""
+
#: website/public/guides/rl-environments/index.html:111
msgctxt "page:guides/rl-environments/index.html"
msgid "Skip to content"
diff --git a/website/locales/tr/messages.po b/website/locales/tr/messages.po
index 149d16c376..fd31000601 100644
--- a/website/locales/tr/messages.po
+++ b/website/locales/tr/messages.po
@@ -15022,6 +15022,42 @@ msgctxt "page:guides/index.html"
msgid "Build an RL environment"
msgstr "Ortam oluşturma rehberi"
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:228
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid "{ph0}Build a desktop app environment{ph1}"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:492
+msgctxt "page:guides/rl-environments/index.html"
+msgid "Build a desktop app environment"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:493
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"For a Linux desktop app, describe the task you want an agent to practice. "
+"For example, ask it to build a Gnote environment where the agent adds olive "
+"oil to a shopping list. The agent installs the app on a local build "
+"computer, writes the task, exports the environment, and checks it on a fresh"
+" computer using screenshots, the mouse, and the keyboard."
+msgstr ""
+
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:501
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"The build host needs Linux on amd64 or arm64, Docker, and the pinned "
+"AgentEnv version. Follow the {ph0}desktop build setup guide{ph1} for "
+"installation and readiness checks."
+msgstr ""
+
#: website/public/guides/rl-environments/index.html:111
msgctxt "page:guides/rl-environments/index.html"
msgid "Skip to content"
diff --git a/website/locales/uk/messages.po b/website/locales/uk/messages.po
index c050d32f73..67c0573898 100644
--- a/website/locales/uk/messages.po
+++ b/website/locales/uk/messages.po
@@ -15102,6 +15102,42 @@ msgctxt "page:guides/index.html"
msgid "Build an RL environment"
msgstr "Посібник зі створення середовища"
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:228
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid "{ph0}Build a desktop app environment{ph1}"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:492
+msgctxt "page:guides/rl-environments/index.html"
+msgid "Build a desktop app environment"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:493
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"For a Linux desktop app, describe the task you want an agent to practice. "
+"For example, ask it to build a Gnote environment where the agent adds olive "
+"oil to a shopping list. The agent installs the app on a local build "
+"computer, writes the task, exports the environment, and checks it on a fresh"
+" computer using screenshots, the mouse, and the keyboard."
+msgstr ""
+
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:501
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"The build host needs Linux on amd64 or arm64, Docker, and the pinned "
+"AgentEnv version. Follow the {ph0}desktop build setup guide{ph1} for "
+"installation and readiness checks."
+msgstr ""
+
#: website/public/guides/rl-environments/index.html:111
msgctxt "page:guides/rl-environments/index.html"
msgid "Skip to content"
diff --git a/website/locales/ur-Latn/messages.po b/website/locales/ur-Latn/messages.po
index 9f430379e3..228b8562db 100644
--- a/website/locales/ur-Latn/messages.po
+++ b/website/locales/ur-Latn/messages.po
@@ -13159,6 +13159,42 @@ msgctxt "page:guides/index.html"
msgid "Build an RL environment"
msgstr "Environment banane ki rehnumai"
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:228
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid "{ph0}Build a desktop app environment{ph1}"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:492
+msgctxt "page:guides/rl-environments/index.html"
+msgid "Build a desktop app environment"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:493
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"For a Linux desktop app, describe the task you want an agent to practice. "
+"For example, ask it to build a Gnote environment where the agent adds olive "
+"oil to a shopping list. The agent installs the app on a local build "
+"computer, writes the task, exports the environment, and checks it on a fresh"
+" computer using screenshots, the mouse, and the keyboard."
+msgstr ""
+
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:501
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"The build host needs Linux on amd64 or arm64, Docker, and the pinned "
+"AgentEnv version. Follow the {ph0}desktop build setup guide{ph1} for "
+"installation and readiness checks."
+msgstr ""
+
#: website/public/guides/rl-environments/index.html:111
msgctxt "page:guides/rl-environments/index.html"
msgid "Skip to content"
diff --git a/website/locales/vi/messages.po b/website/locales/vi/messages.po
index dc93190373..8c33f05cc7 100644
--- a/website/locales/vi/messages.po
+++ b/website/locales/vi/messages.po
@@ -14994,6 +14994,42 @@ msgctxt "page:guides/index.html"
msgid "Build an RL environment"
msgstr "Hướng dẫn xây dựng môi trường"
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:228
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid "{ph0}Build a desktop app environment{ph1}"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:492
+msgctxt "page:guides/rl-environments/index.html"
+msgid "Build a desktop app environment"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:493
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"For a Linux desktop app, describe the task you want an agent to practice. "
+"For example, ask it to build a Gnote environment where the agent adds olive "
+"oil to a shopping list. The agent installs the app on a local build "
+"computer, writes the task, exports the environment, and checks it on a fresh"
+" computer using screenshots, the mouse, and the keyboard."
+msgstr ""
+
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:501
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"The build host needs Linux on amd64 or arm64, Docker, and the pinned "
+"AgentEnv version. Follow the {ph0}desktop build setup guide{ph1} for "
+"installation and readiness checks."
+msgstr ""
+
#: website/public/guides/rl-environments/index.html:111
msgctxt "page:guides/rl-environments/index.html"
msgid "Skip to content"
diff --git a/website/locales/zh-CN/messages.po b/website/locales/zh-CN/messages.po
index 96f16f7760..21ab8fc8ef 100644
--- a/website/locales/zh-CN/messages.po
+++ b/website/locales/zh-CN/messages.po
@@ -13687,6 +13687,46 @@ msgctxt "page:guides/index.html"
msgid "Build an RL environment"
msgstr "构建环境指南"
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:228
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid "{ph0}Build a desktop app environment{ph1}"
+msgstr "{ph0}构建桌面应用环境{ph1}"
+
+#: website/public/guides/rl-environments/index.html:492
+msgctxt "page:guides/rl-environments/index.html"
+msgid "Build a desktop app environment"
+msgstr "构建桌面应用环境"
+
+#: website/public/guides/rl-environments/index.html:493
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"For a Linux desktop app, describe the task you want an agent to practice. "
+"For example, ask it to build a Gnote environment where the agent adds olive "
+"oil to a shopping list. The agent installs the app on a local build "
+"computer, writes the task, exports the environment, and checks it on a fresh"
+" computer using screenshots, the mouse, and the keyboard."
+msgstr ""
+"对于 Linux 桌面应用,先描述你希望智能体练习的任务。例如,让它为 Gnote "
+"构建一个环境,练习把橄榄油添加到购物清单。智能体会在本地构建机上安装应用、编写任务并导出环境,然后在一台全新的机器上通过截图、鼠标和键盘验证任务。"
+
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:501
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"The build host needs Linux on amd64 or arm64, Docker, and the pinned "
+"AgentEnv version. Follow the {ph0}desktop build setup guide{ph1} for "
+"installation and readiness checks."
+msgstr ""
+"构建机需要运行 amd64 或 arm64 版 Linux,并安装 Docker 和指定版本的 "
+"AgentEnv。请按{ph0}桌面环境构建机设置指南{ph1}安装所需软件并检查机器是否就绪。"
+
#: website/public/guides/rl-environments/index.html:111
msgctxt "page:guides/rl-environments/index.html"
msgid "Skip to content"
diff --git a/website/locales/zh-TW/messages.po b/website/locales/zh-TW/messages.po
index 420eb00475..b42fe1bf52 100644
--- a/website/locales/zh-TW/messages.po
+++ b/website/locales/zh-TW/messages.po
@@ -13704,6 +13704,42 @@ msgctxt "page:guides/index.html"
msgid "Build an RL environment"
msgstr "建立環境指南"
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:228
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid "{ph0}Build a desktop app environment{ph1}"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:492
+msgctxt "page:guides/rl-environments/index.html"
+msgid "Build a desktop app environment"
+msgstr ""
+
+#: website/public/guides/rl-environments/index.html:493
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"For a Linux desktop app, describe the task you want an agent to practice. "
+"For example, ask it to build a Gnote environment where the agent adds olive "
+"oil to a shopping list. The agent installs the app on a local build "
+"computer, writes the task, exports the environment, and checks it on a fresh"
+" computer using screenshots, the mouse, and the keyboard."
+msgstr ""
+
+#. {ph0}:
+#. {ph1}:
+#: website/public/guides/rl-environments/index.html:501
+#, python-brace-format
+msgctxt "page:guides/rl-environments/index.html"
+msgid ""
+"The build host needs Linux on amd64 or arm64, Docker, and the pinned "
+"AgentEnv version. Follow the {ph0}desktop build setup guide{ph1} for "
+"installation and readiness checks."
+msgstr ""
+
#: website/public/guides/rl-environments/index.html:111
msgctxt "page:guides/rl-environments/index.html"
msgid "Skip to content"
diff --git a/website/public/guides/rl-environments/index.html b/website/public/guides/rl-environments/index.html
index fb0555940f..8f62462737 100644
--- a/website/public/guides/rl-environments/index.html
+++ b/website/public/guides/rl-environments/index.html
@@ -225,6 +225,7 @@
Run the environment
Add tasks and rewards
Check what works
+ Build a desktop app environment
@@ -487,6 +488,26 @@
covers direct MCP serving, state controls, and limits.
+
+ Build a desktop app environment
+
+ For a Linux desktop app, describe the task you want an agent to
+ practice. For example, ask it to build a Gnote environment where
+ the agent adds olive oil to a shopping list. The agent installs
+ the app on a local build computer, writes the task, exports the
+ environment, and checks it on a fresh computer using screenshots,
+ the mouse, and the keyboard.
+
+
+ The build host needs Linux on amd64 or arm64, Docker, and the
+ pinned AgentEnv version. Follow the
+ desktop build setup guide
+ for installation and readiness checks.
+
+