# HermesOffice
**The world's first full-featured open-source AI Office suite.**
[](LICENSE)
[](https://github.com/criptogus/HermesOffice/releases/latest)
[](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)
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.
[](https://www.youtube.com/watch?v=B2pLdMX95v4)
[Watch the demo video on YouTube](https://www.youtube.com/watch?v=B2pLdMX95v4)
## Features
- **Real PDF editing** โ retype text and edit images in the page itself, original fonts preserved.
- **Local PDF โ Word / PowerPoint / Excel conversion** โ turn a PDF into an editable `.docx`, `.pptx`, or `.xlsx` entirely on your machine: no cloud, no upload.
- **Scanned PDFs too** โ on macOS and Windows scanned pages are read with the system OCR, so they convert to editable text.
- **Microsoft Wordโcompatible, byte-preserving `.docx` editing** โ only what you touched changes; Word never notices.
- **Word-faithful pagination** โ page breaks land where Word puts them.
- **Excel-compatible spreadsheets** โ in-house engine with a Rust `.xlsx` sidecar, own charts, pivot tables, slicers.
- **PowerPoint-compatible presentations** โ in-house `.pptx` engine with masters, layouts, smart guides, non-destructive crop.
- **Markdown to Word, fully local** โ the same OOXML engine, no Pandoc, no cloud.
- **AI that edits documents** โ block-level edits with snapshots and diffs, document-aware agents.
- **Bring your own key (BYOK)** โ run the AI on your own API key: Claude, OpenAI, Gemini, DeepSeek, Kimi, GLM, Qwen, Doubao, MiniMax, Grok, Mistral, OpenRouter, or any OpenAI-compatible endpoint โ or sign in with Genspark and skip keys entirely.
- **Agent tools built in** โ web/image search, image generation, media analysis.
- **Light / dark / system themes.**
- **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
to the applications menu:
```bash
sudo apt install ./hermesoffice_<version>_amd64.deb
```
On Fedora / RHEL-family / openSUSE, install the rpm instead:
```bash
sudo dnf install ./hermesoffice-<version>.x86_64.rpm # Fedora / RHEL family
sudo zypper install ./hermesoffice-<version>.x86_64.rpm # openSUSE
```
The AppImage instead runs in place: install the FUSE 2 runtime
(`sudo apt install libfuse2`; on Ubuntu 24.04 the package is `libfuse2t64`),
make the file executable, then run it:
```bash
chmod +x HermesOffice-<version>.AppImage
./HermesOffice-<version>.AppImage
```
## Screenshots
| Docs | PDF |
| ---------------------------------- | -------------------------------- |
|  |  |
## Apps
| App | Product | What it is |
| --------------- | ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `apps/docs` | **HermesOffice Docs** | `.docx` word processor. Byte-preserving round trip: only dirty paragraphs are regenerated (paragraph patch), everything else in the original file is kept byte-for-byte, so opening and saving never breaks layout in Word. Paginated view whose line metrics reproduce the original document's layout, tracked changes, comments, styles, equations, ink. |
| `apps/sheets` | **HermesOffice Sheets** | `.xlsx` spreadsheet. UI built on the open-source [Univer](https://github.com/dream-num/univer) core (Apache-2.0) with a large layer of in-house extensions; `.xlsx` import/export runs through an in-house Rust sidecar (calamine + IronCalc), charts are rendered in-house (Konva), plus pivot tables, slicers, conditional formatting, and formula tracing. |
| `apps/slides` | **HermesOffice Slides** | `.pptx` presentations. In-house `.pptx` parse/render/edit engine with masters, charts, cropping, ink, and text shaping (HarfBuzz metrics). |
| `apps/pdf` | **HermesOffice PDF** | `.pdf` viewer/editor on [pdf.js](https://github.com/mozilla/pdf.js) (Apache-2.0) + [pdf-lib](https://github.com/Hopding/pdf-lib) (MIT): annotations, forms, outlines, stamps, signatures, page operations, and printing support. True text editing โ paragraph selection with in-block reflow, alignment restoration, original-font preservation โ and content-stream image insert/edit, all rewriting page content streams through [PDFium](https://pdfium.googlesource.com/pdfium/) wasm (BSD-3-Clause) with subset-embedded fonts โ no cover-up annotations. Converts PDFs into editable Word, PowerPoint, and Excel files fully locally (`packages/pdf2docx`), with OCR support for scanned pages (system OCR on macOS and Windows). |
| `apps/markdown` | **HermesOffice Markdown** | `.md` / `.markdown` editor: Tiptap block editor over plain Markdown files โ headings, lists, tables, images, code blocks โ saved back as plain Markdown, hosted in shell tabs. |
| `apps/shell` | **HermesOffice** | The suite shell: home screen, tabbed hosting of the five editors, light/dark/system theme, auto-update. |
Every app embeds the same AI panel: block-granular AI editing with version
snapshots and diffs in docs, a tool-calling agent over workbook/slide/PDF
state in the others.
The whole suite ships light / dark / system UI themes built on shared design
tokens (`packages/ui`), with a CI guard that keeps chrome colors on the token
system. Document surfaces stay light in dark mode โ Word-style dark chrome
around white paper โ so files render and export identically in both themes.
**AI backends โ Genspark sign-in or bring your own key.** By default the
apps sign in to a Genspark account through a device-code flow โ no model API
key to enter โ and model calls route through the Genspark proxy (Claude,
GPT, and Gemini families). Or bring your own key (BYOK) in the AI settings:
Claude, OpenAI, Gemini, DeepSeek, Kimi, GLM, Qwen, Doubao, MiniMax, Grok,
Mistral, and OpenRouter are built in, plus a custom provider slot for any
OpenAI-compatible endpoint (base URL + key), local servers included. A
Genspark account also unlocks the Genspark ("gsk") tool endpoints the agents
build on โ web and image search, image generation and editing,
image/audio/video analysis, and audio transcription โ all reachable through
`packages/ai-search` for anyone extending the agent layer.
## Engine packages
All pure TypeScript, no Electron dependency, unit-tested (except the UI kit):
- `packages/docx-engine` โ docx parsing โ block tree (with `docxIndex`
anchors and passthrough), OOXML fragment generation, byte-level paragraph
patching.
- `packages/pptx-engine` / `packages/pptx-render` โ pptx model and rendering.
- `packages/pdf2docx` โ local PDF โ DOCX conversion: PDFium character-level
extraction, pure-geometry layout analysis, rebuild through `docx-engine`;
the same analysis drives the PDF app's PowerPoint and Excel exports.
- `packages/file-parse` โ text extraction for AI attachments (office formats,
text formats).
- `packages/agent-core` โ the AI agent loop and skill composition shared by
every app.
- `packages/ai-provider` โ provider abstraction and streaming for the model
backends.
- `packages/ai-search` โ Genspark auth + web/image search tools.
- `packages/i18n`, `packages/ui`, `packages/project-store`,
`packages/electron-utils` โ shared i18n core, React UI kit, recent-files
store, and Electron main-process helpers.
## Development
```bash
npm install
npm run fixtures # generate test .docx fixtures
npm test # engine + app unit tests (docs/sheets/slides need no display)
npm run typecheck # tsc --noEmit across every workspace
npm run dev # all five editors + shell against Vite dev servers
npm run dev:docs # a single app (same pattern works per workspace)
npm run dist:mac # package macOS dmg (regenerates third-party notices)
npm run dist:win # package Windows nsis installer
npm run dist:linux # package Linux AppImage + deb + rpm
```
The sheets app additionally needs a Rust toolchain for its xlsx sidecar
(`cargo` on PATH); `npm run build -w @hermesoffice/sheets` compiles it
automatically.
Local UI/e2e driver scripts (Playwright + Electron, for local acceptance, not
committed by default) live in [`scripts/drivers/`](scripts/drivers/README.md).
## Architecture notes (docx round trip)
```
open docx โโบ archive original by hash (never touched)
โโบ docx-engine parses word/document.xml top-level elements (w:p / w:tbl / โฆ)
โโบ Block tree, each block anchored by docxIndex + original XML slice
โโบ Tiptap streaming editor (manual + AI editing, dirty tracking)
save โโบ dirty blocks โ OOXML fragments (referencing existing styles only)
โโบ splice into original document.xml (untouched blocks keep original bytes)
โโบ repack zip; all other entries copied byte-for-byte
```
The same philosophy holds in sheets and slides: the original file is the
source of truth, edits are applied as narrow patches, and everything the
editor didn't touch survives the round trip untouched.
## FAQ
**Is HermesOffice free?**
Yes. HermesOffice is free and open-source under the Apache-2.0 license โ no
trial, no paid tier for the apps themselves.
**Can HermesOffice open Microsoft Word, Excel, and PowerPoint files?**
Yes. HermesOffice opens and saves native `.docx`, `.xlsx`, and `.pptx` files.
Saving is byte-preserving: parts of the file you didn't touch are written
back byte-for-byte, so documents keep working in Microsoft Office.
**Does HermesOffice work offline?**
Document editing is fully local โ files never leave your machine to be
opened, edited, or saved. The AI features (agents, search, image tools) need
a network connection, with either a Genspark sign-in or your own model API
key (BYOK).
**Can HermesOffice edit PDF files?**
Yes โ real PDF text and image editing that rewrites the page content stream
with the original fonts preserved, not cover-up annotations.
**Can HermesOffice convert PDF to Word, Excel, or PowerPoint?**
Yes โ HermesOffice converts PDFs into editable `.docx`, `.xlsx`, and `.pptx`
files entirely on-device: PDFium character-level extraction plus
geometry-based layout analysis, no cloud service, no upload. Scanned pages are
covered too โ on macOS and Windows the system OCR reads them, so they convert
to editable text rather than a page image.
**Can I use my own AI model or API key?**
Yes. Besides the keyless Genspark sign-in, HermesOffice supports bring your own
key (BYOK) for Claude, OpenAI, Gemini, DeepSeek, Kimi, GLM, Qwen, Doubao,
MiniMax, Grok, Mistral, and OpenRouter, plus any OpenAI-compatible endpoint
โ including local model servers.
**Does HermesOffice collect any data?**
Official packaged builds send limited usage analytics by default, and you can
disable reporting at any time under Settings โ General. Analytics never sends
document content, file names, file paths, account identity, or email addresses.
See [HermesOffice Privacy](PRIVACY.md) for the complete event and data disclosures.
## Security
See [SECURITY.md](SECURITY.md) for the process security posture (renderer
sandboxing, IPC validation, external-link gating) and the threat models for
AI-generated content.
## Acknowledgements
HermesOffice would not be possible without these open-source projects:
- [Electron](https://www.electronjs.org/) โ the desktop runtime for every app.
- [Univer](https://github.com/dream-num/univer) (Apache-2.0) โ the spreadsheet
UI core that Sheets extends.
- [PDFium](https://pdfium.googlesource.com/pdfium/) (BSD-3-Clause, bundled via
[@embedpdf/pdfium](https://github.com/embedpdf/embed-pdf-viewer)) โ the
content-stream engine behind true PDF text and image editing.
- [pdf.js](https://github.com/mozilla/pdf.js) (Apache-2.0) and
[pdf-lib](https://github.com/Hopding/pdf-lib) (MIT) โ PDF rendering and
document assembly.
- [Tiptap](https://tiptap.dev/) / [ProseMirror](https://prosemirror.net/) โ
the block editors in Docs and Markdown.
- [Konva](https://konvajs.org/) โ canvas rendering for Slides and Sheets
charts.
- [HarfBuzz](https://github.com/harfbuzz/harfbuzz) (wasm) โ text-shaping
metrics for complex scripts.
- [calamine](https://github.com/tafia/calamine) and
[IronCalc](https://github.com/ironcalc/IronCalc) โ the read and calc layers
of the Rust xlsx sidecar.
- Liberation, Carlito, Caladea, and Noto CJK fonts (OFL/Apache-2.0) โ bundled
document fonts.
## Third-party notices
`npm run notices` regenerates the bundled third-party license summary
(`tools/gen-third-party-notices.mjs`); all runtime dependencies are
MIT/Apache-2.0/BSD-3-Clause/OFL, and the bundled fonts (Liberation, Carlito,
Caladea, Noto CJK subsets) are OFL/Apache.
## License
HermesOffice is licensed under the [Apache License 2.0](LICENSE), with one
exception: the `ee/` directory is reserved for future enterprise modules and
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.