criptogus/HermesOffice

HermesOffice – 오픈소스 AI 기반 사무실 스위트

무엇인가요 – HermesOffice는 macOS, Windows, Linux를 지원하는 크로스플랫폼 사무실 스위트로, Microsoft Office의 네이티브 형식(.docx, .xlsx, .pptx)과 함께 PDF 및 Markdown 파일도 열고 편집, 저장할 수 있습니다. 특징적인 점은 AI 기반 편집 기능이 별도의 채팅 창이 아닌 각 편집기 내에 내장되어 있다는 것입니다.

주요 구성 요소

• Docs – 원본 파일의 변경되지 않은 모든 바이트를 유지하므로, 편집하지 않는 한 레이아웃이 변경되지 않습니다. Word의 페이지 나누기와 일치하는 페이지 기반 표시를 제공합니다.
• Sheets – 오픈소스 Univer UI 코어 기반의 스프레드시트로, 자체 개발한 Rust 사이드카(calamine + IronCalc)가 .xlsx 파싱, 차트, 피벗 테이블, 슬라이서, 조건부 서식을 처리합니다.
• Slides – PowerPoint 호환 프레젠테이션 도구로, 자체 .pptx 파서/렌더 엔진을 갖추고 있으며, 마스터, 레이아웃, 스마트 가이드, 비파괴적 이미지 자르기 기능을 지원합니다.
• PDF – pdf.js, pdf-lib, PDFium을 WebAssembly로 컴파일한 진정한 PDF 편집기로, 텍스트 재입력, 이미지 편집, 원본 폰트 유지가 가능합니다. 또한 OS 제공 OCR 서비스를 사용해 스캔된 페이지에 OCR을 적용하고, 로컬에서 PDF를 Word, Excel, PowerPoint로 변환할 수 있습니다.
• Markdown – 단순한 Tiptap/ProseMirror 블록 에디터로, 순수 .md 파일을 직접 편집할 수 있습니다.
• Shell – 다섯 개의 에디터를 탭으로 호스팅하는 스위트의 런처로, 테마(라이트/다크/시스템) 관리 및 자동 업데이트를 담당합니다.

AI 통합

• 각 에디터에는 블록 단위 편집, 스냅샷 및 차이점 표시, 도구 호출이 가능한 AI 패널이 내장되어 있습니다.
• AI는 자신의 키 제공 (BYOK) 모델 제공자 방식으로 작동합니다. Claude, OpenAI, Gemini, DeepSeek, Kimi, GLM, Qwen, Doubao, MiniMax, Grok, Mistral, OpenRouter 또는 OpenAI 호환 엔드포인트(로컬 서버 포함)의 API 키를 연결할 수 있습니다.
• 또는 Genspark(디바이스 코드 흐름)에 로그인하여 서비스가 Claude, GPT, Gemini 호출을 프록시하고, 추가 도구 엔드포인트(웹/이미지 검색, 이미지 생성, 미디어 분석, 음성 인식)를 제공할 수 있습니다.
• 에이전트 코어(packages/agent-core)는 도구 호출을 조율하고, packages/ai-search 모듈은 Genspark 전용 도구를 구현합니다.

설치

• macOS (Apple Silicon) – 최신 릴리스에서 사전 빌드된 서명된 .dmg (아드혹) 또는 .zip.
• 기타 플랫폼 – 소스 빌드 제공. README에 npm 명령어(npm run dist:win, npm run dist:linux)가 기재되어 있으며, Windows 설치 프로그램, Linux AppImage, .deb, .rpm 패키지를 생성합니다.
• Linux 패키지는 glibc ≥ 2.34가 필요하며, AppImage의 경우 FUSE 2 런타임이 필요합니다.

개발 및 아키텍처

• 프로젝트는 순수 TypeScript 패키지의 모노레포(엔진 내에 Electron 의존 없음)와 Excel 사이드카용 몇몇 Rust 도구로 구성됩니다.
• 핵심 엔진(docx-engine, pptx-engine, pdf2docx 등)은 원본 OOXML/PDF 파일을 분석하고 블록 트리를 구축하며, 저장 시 편집된 블록만 삽입하여 나머지 아카이브는 바이트 단위로 완전히 유지합니다.
• UI는 React로 구축되며, 공유 디자인 토큰(packages/ui)을 사용하고, 데스크톱 호스트에는 Electron을 사용합니다.
• 테스트는 엔진용 Jest, UI 수락 테스트용 Playwright + Electron을 사용합니다.

라이선스 및 커뮤니티

• Apache-2.0 라이선스, 완전 무료 및 오픈소스입니다.
• 공식 빌드는 선택적 익명 사용 분석을 전송합니다(문서 내용은 포함되지 않음). 설정에서 비활성화 가능합니다.
• 보안 정책, 개인정보 보호 정책, 제3자 고지 사항은 리포지토리에 제공됩니다.

결론 – HermesOffice는 본격적이고 야심 찬 프로젝트로, 완전한 사무실 스위트 기능과 로컬에서 실행되는 AI 지원을 결합하며, 다양한 모델 제공자와 전문가 사용자가 기대하는 문서의 본질적 정확성을 유지합니다.