HermesOffice

An AI-native office suite for macOS and Windows: word processor, spreadsheet,
presentations, and PDF — five Electron apps sharing one engine layer, built
around AI editing as a first-class workflow rather than a bolted-on chat box.

Watch the demo video on YouTube

Download

All builds come from main; the macOS and Windows installers are signed.
Older versions are on the Releases page.

Installing on Linux

The deb installs with apt — it pulls in the dependencies and adds HermesOffice
to the applications menu:

sudo apt install ./hermesoffice_0.5.149_amd64.deb

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:

chmod +x HermesOffice-0.5.149.AppImage
./HermesOffice-0.5.149.AppImage

Apps

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.

AI providers. The apps sign in to a Genspark account and route model
calls through the Genspark service side; no model API key is stored locally.

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/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

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 four 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

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/.

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.

Security

See SECURITY.md for the process security posture (renderer
sandboxing, IPC validation, external-link gating) and the threat models for
AI-generated content.

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/OFL, and the bundled fonts (Liberation, Carlito, Caladea, Noto
CJK subsets) are OFL/Apache.

License

HermesOffice is licensed under the Apache License 2.0, with one
exception: the ee/ directory is reserved for future enterprise modules and
is covered by the HermesOffice Enterprise 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.