diff --git a/README.md b/README.md
index 7ba912d48..c63a070b8 100644
--- a/README.md
+++ b/README.md
@@ -1,24 +1,62 @@
# HermesOffice
-**The world's first full-featured open-source AI Office suite.**
+**The open-source AI office suite.** Word processor, spreadsheet, presentation
+editor, PDF editor and Markdown editor in a single app — real `.docx`, `.xlsx`
+and `.pptx` files, edited byte-preservingly, with AI editing built into every
+app instead of bolted on as a chat box.
-[](LICENSE)
+[](https://github.com/criptogus/HermesOffice/actions/workflows/ci.yml)
+[](https://github.com/criptogus/HermesOffice/actions/workflows/main-build.yml)
[](https://github.com/criptogus/HermesOffice/releases/latest)
+[](LICENSE)
[](https://github.com/criptogus/HermesOffice/releases)
-[Download](https://github.com/criptogus/HermesOffice/releases/latest) · [Privacy](PRIVACY.md) · [Demo](https://www.youtube.com/watch?v=B2pLdMX95v4)
+
+
+
+
+
+**[⬇ Download for macOS](#download)** ·
+[Watch the demo](https://www.youtube.com/watch?v=B2pLdMX95v4) ·
+[Contributing](CONTRIBUTING.md) ·
+[Security](SECURITY.md) ·
+[Privacy](PRIVACY.md)
HermesOffice is a free, open-source alternative to Microsoft Office for macOS,
-Windows, and Linux, built around AI editing as a first-class workflow rather
-than a bolted-on chat box. It opens and saves the real Microsoft Office
-formats — Word (`.docx`), Excel (`.xlsx`), PowerPoint (`.pptx`) — and edits
-PDF and Markdown too: a word processor, spreadsheet, presentation editor,
-PDF editor, and Markdown editor as six Electron apps sharing one engine
-layer.
+Windows, and Linux. Every app embeds the same AI panel — block-level edits with
+snapshots and diffs, document-aware agents, web/image search, and image
+generation — and you can run it on your own API key (Claude, OpenAI, Gemini,
+DeepSeek, Kimi, GLM, Qwen and more) or a keyless Genspark sign-in.
+
+## Download
+
+### Stable
+
+| Platform | Requirements | Download |
+| ------------------------- | -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **macOS** — Apple Silicon | macOS 11+ | **[`.dmg`](https://github.com/criptogus/HermesOffice/releases/latest/download/HermesOffice-arm64.dmg)** · [`.zip`](https://github.com/criptogus/HermesOffice/releases/latest/download/HermesOffice-arm64-mac.zip) |
+| **Windows** (x64) | Windows 10+ | [build from source](#development) |
+| **Linux** (x86_64) | glibc 2.34+, FUSE 2 for AppImage | [build from source](#development) |
+
+The `releases/latest/download/…` links above never change — they always point
+at the newest stable build. Older versions live on the
+[Releases](https://github.com/criptogus/HermesOffice/releases) page.
+
+### Nightly — built on every push to `main`
+
+**[⬇ HermesOffice-nightly-arm64-mac.zip](https://github.com/criptogus/HermesOffice/releases/download/ho-nightly/HermesOffice-nightly-arm64-mac.zip)**
-[](https://www.youtube.com/watch?v=B2pLdMX95v4)
+The nightly channel ships the latest `main` as a rolling prerelease, built
+automatically on every push. Installed apps detect it on their own: the app
+checks for updates shortly after launch, every 4 hours and when the window
+regains focus, then offers **Update Now** — which downloads the build,
+verifies it and swaps it into place without a reinstall. Stable `ho-v*`
+releases always take priority over the nightly.
-[Watch the demo video on YouTube](https://www.youtube.com/watch?v=B2pLdMX95v4)
+macOS builds are **ad-hoc signed, not notarized** (no Apple Developer ID yet),
+so the first launch of a manually downloaded build needs one confirmation:
+right-click the app → **Open**, or allow it under **System Settings → Privacy
+& Security**. Updates applied from inside the app skip this step.
## Features
@@ -37,26 +75,6 @@ layer.
- **macOS, Windows, Linux.**
- **Free & open-source (Apache-2.0).**
-## Download
-
-**macOS · Apple Silicon — [download the latest `.dmg`](https://github.com/criptogus/HermesOffice/releases/latest/download/HermesOffice-arm64.dmg)**
-One click, always the newest build. That link never changes — it is also the one to share or put on a page.
-
-| Platform | Requirements | Download |
-| ------------------------------------ | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **macOS** — Apple Silicon (arm64) | macOS 11+ | [`.dmg`](https://github.com/criptogus/HermesOffice/releases/latest/download/HermesOffice-arm64.dmg) · [`.zip`](https://github.com/criptogus/HermesOffice/releases/latest/download/HermesOffice-arm64-mac.zip) |
-| **macOS** — Intel (x64) | macOS 11+ | [build from source](#development) — no published artifact yet |
-| **Windows** (x64) | Windows 10+ | [build from source](#development) — no published artifact yet |
-| **Linux** — Debian / Ubuntu | x86_64, glibc 2.34+ | [build from source](#development) — no published artifact yet |
-| **Linux** — Fedora / RHEL / openSUSE | x86_64, glibc 2.34+ | [build from source](#development) — no published artifact yet |
-| **Linux** — other distributions | x86_64, glibc 2.34+, FUSE 2 | [build from source](#development) — no published artifact yet |
-
-Builds come from `main`. The macOS bundle is **ad-hoc signed, not notarized** (there is no
-Apple Developer ID behind it yet), so the first launch needs one confirmation: right-click
-the app → **Open**, or allow it under **System Settings → Privacy & Security**.
-
-Older versions are on the [Releases](https://github.com/criptogus/HermesOffice/releases) page.
-
### Installing on Linux
The deb installs with apt — it pulls in the dependencies and adds HermesOffice
@@ -84,9 +102,13 @@ chmod +x HermesOffice-.AppImage
## Screenshots
-| Docs | PDF |
-| ---------------------------------- | -------------------------------- |
-|  |  |
+| Docs — AI editing | Sheets — AI assistant | Slides — AI generation |
+| ------------------------------------------- | ----------------------------------------------- | ----------------------------------------------- |
+|  |  |  |
+
+| PDF — real text editing | HTML — AI restyle | Markdown — AI panel |
+| --------------------------------------------- | ------------------------------------------- | --------------------------------------------------- |
+|  |  |  |
## Apps
@@ -144,6 +166,9 @@ All pure TypeScript, no Electron dependency, unit-tested (except the UI kit):
## Development
+TypeScript · Electron · React · Rust xlsx sidecar · ~17,000 unit tests ·
+Playwright E2E against the real built app.
+
```bash
npm install
npm run fixtures # generate test .docx fixtures
@@ -266,3 +291,15 @@ is covered by the [HermesOffice Enterprise License](ee/LICENSE).
The HermesOffice and Genspark names and logos are trademarks of Mainfunc, Inc.
The Apache-2.0 license does not grant permission to use them (see section 6);
forks should use their own branding.
+
+---
+
+
+