hissih/sumoffice-preview repository overview

⁠SumOffice Preview — document previews for your product, one container

Thumbnails, HTML pages and PDF from Word and Excel files (.docx, .doc, .odt, .xlsx, .xlsm, .xlsb, .xls) without an office suite. Fonts with Office metrics are inside, so text never turns into squares. The engines are SumDoc and SumSheet — the same ones behind sumoffice.com⁠. No network needed after pull; each request’s files are deleted right after the response.

docker run -d -p 8099:8099 hissih/sumoffice-preview
curl -F [email protected] http://localhost:8099/thumb?w=320 > thumb.png    # first page, PNG
curl -F [email protected] http://localhost:8099/pages > report.html        # all pages, one HTML file
curl -F [email protected] http://localhost:8099/pdf   > report.pdf
curl -F [email protected]   http://localhost:8099/thumb > book.png           # first sheet as a grid
curl -F [email protected]   http://localhost:8099/pages > book.html          # every sheet as a table

Raw body instead of multipart: POST /thumb?name=report.docx with the file bytes (or the X-File-Name header). GET /health lists the engines and formats.

⁠Honest by contract

Every answer carries headers: X-Preview-Pages (page count from the full layout), X-Preview-Coverage: N/M pages and X-Preview-Partial: true when the HTML viewer drew fewer pages than the PDF, X-Preview-Scripts-Outside-Font, and for workbooks X-Preview-Sheets, X-Preview-Cells, X-Preview-Uncomputed-Formulas. Unknown formats get 415 with a readable sentence; presentations say “SumPoint, December 2026”.

⁠Size, speed, footprint

224 MB image, Debian 13, no npm, runs as a non-root user, healthcheck on /health. About 250 MB of RAM per concurrent document; a thumbnail takes tens of milliseconds natively (0.3–0.6 s under x86 emulation on a laptop). Measured on 20 corpus files: 20 of 20 thumbnails, none empty.

⁠Licensing

Evaluation is free with no time limit; view-only use stays free. Production use inside a product is licensed per embedding application or per volume — sumoffice.com/licensing⁠. Try it in the browser first: sumoffice.com/preview⁠.

⁠Tags