TL;DR
Univer (dream-num/univer) is a TypeScript SDK for putting a real spreadsheet, and a rich-text document editor, inside your own product. It is not an office suite you install. It is the engine you build one with: content models, a formula engine, a Canvas renderer, a command and undo system, and a “Facade” API that your app code, or an AI agent, uses to read and edit the same workbook a person sees on screen. The same content plugins also run headless in Node.js, with no editor and no browser.
As of November 22, 2026 the repository has 31,172 stars (7,240 of them this week, per GitHub Trending), 2,838 forks, 89 open issues, an Apache-2.0 license, and its latest release is v1.6.0 (November 21, 2026). Releases ship roughly weekly: v1.4.0, v1.5.0, v1.5.1, v1.5.2 and v1.6.0 all landed in November.
The catch is the business model. The open-source core covers Sheets editing, formulas, filtering, sorting, validation, conditional formatting and comments, plus Docs. XLSX import and export, charts, pivot tables, printing, real-time collaboration, the Server SDK and the AI SDK are commercial, with a watermarked free tier and production licenses from $99 per month. If you need an embeddable grid with a serious formula engine and you own persistence yourself, the free part is a strong base. If you need to round-trip Excel files, budget for a license or pair it with a separate file library.
Not run by us: our hands-on lab (a throwaway GitHub Actions container) could not start on November 22, 2026, because GitHub refused the job over a billing limit on the account. We had prepared a headless Node.js run of the README’s quotation example, a snapshot reload, a formula spot-check and a 10,000-row recalculation; none of it executed. Everything below comes from the repository, the official docs, the v1.6.0 release notes, the vendor’s pricing page and public discussion.
What Univer actually is
Univer describes itself as an “Office SDK for building Office applications inside your own product.” The family covers spreadsheets, documents, presentations, relational tables, canvases (“Boards”) and PDFs, but only part of that is in this repository. The README splits the product into three pieces:
| Part | What it does | License |
|---|---|---|
| Web SDK (this repo) | Content models, editing, Canvas rendering, formula engine, Facade APIs, UI foundation, Sheets and Docs editing; reusable headless in Node | Apache-2.0 |
| Commercial Web SDK plugins | Charts, shapes, pivot tables, SmartArt, Slides, Boards, PDFs and more | Commercial |
| Server SDK | Real-time collaboration (operational transformation), revision history, Office file import and export | Commercial |
| AI SDK | Node APIs and CLI building blocks for agents to inspect, edit, screenshot and review content | Commercial |
What you get for free, according to the README:
- Sheets, editing and layout: cell styles, merged cells, in-cell rich text, freeze panes, floating images, undo/redo.
- Sheets, data and calculation: formulas, defined names, filtering, sorting, data validation, conditional formatting, hyperlinks, comments, find and replace.
- Docs: rich-text editing, paragraph formatting, lists, hyperlinks, comments, drawing integration.
The project has history. Dream-num’s earlier spreadsheet, Luckysheet (16,621 stars), is now archived with the description “Luckysheet upgraded to Univer.” Univer’s own repository dates back to September 2022, so this is not a weekend project riding the agent wave. It is a three-year-old engine whose README was rewritten around agents.
Why it is trending now: the agent angle
The README’s new pitch is that “agents can use the same open-source APIs; your application supplies the model and tool orchestration.” In practice that means a workbook is just an object your code holds. A human edits it in the Canvas UI; an agent edits it by calling getRange().setValues(); the formula engine recalculates for both; and workbook.save() gives you a JSON snapshot to persist.
That is a different shape from the usual agent-plus-spreadsheet setup, where the agent writes an .xlsx with openpyxl or SheetJS and nobody sees the formulas evaluate until a human opens the file. With Univer the agent’s edits happen inside a live model with real formula evaluation, so the agent can read back computed values and check its own work.
The commercial AI SDK goes further: structured inspection of content, an API reference the agent can search for Facade symbols, read and write execution modes that capture mutations, rendered screenshots for visual checks, a slide layout linter, and “Worktree” drafts. A Worktree lets an agent edit an isolated copy over several rounds and hand it to a person to review, merge or reopen. That is a git-branch model applied to documents, and it is the most interesting idea in the project. It is also paid.
Around the core, dream-num has shipped agent entry points: Univer Workspace (2,238 stars, Apache-2.0, a self-hosted workspace where people and agents edit and review documents), Univer CLI (a new local Office CLI for agents, 23 stars as of today), integrations for OpenClaw, DeepSeek Harness and WorkBuddy, and Univer SDK Skills for coding agents. Each of these is open source, but the pricing page says one Office SDK license “enables the commercial features across them,” so the advanced features in those tools still depend on a license.
Getting started: the browser quick start
The README’s quick start uses only open-source packages:
pnpm add @univerjs/presets @univerjs/preset-sheets-core
<div id="app" style="height: 100vh"></div>
import { UniverSheetsCorePreset } from '@univerjs/preset-sheets-core'
import UniverPresetSheetsCoreEnUS from '@univerjs/preset-sheets-core/locales/en-US'
import { createUniver, LocaleType, mergeLocales } from '@univerjs/presets'
import '@univerjs/preset-sheets-core/lib/index.css'
const { univerAPI } = createUniver({
locale: LocaleType.EN_US,
locales: {
[LocaleType.EN_US]: mergeLocales(UniverPresetSheetsCoreEnUS),
},
presets: [
UniverSheetsCorePreset({ container: 'app' }),
],
})
univerAPI.createWorkbook({})
That gives you a spreadsheet editor in the page. In React or Vue, keep the univer instance returned by createUniver and call univer.dispose() on unmount. The README also warns to keep all @univerjs/* packages on the same version, which matters with a weekly release cadence: a half-upgraded dependency tree is the first thing to check when something breaks.
For fine-grained control, “Plugin Mode” registers each plugin by hand; the README’s Plugin Mode example for the same Sheets Core stack lists 14 packages, plus locale bundles, CSS files and Facade imports.
Driving the workbook from code (or an agent)
The Facade API is the part an agent would call. This is the README’s quotation example: wait for the formula engine to be ready, write values and formulas, change one input, then read the recalculated total.
// Wait for formula controllers before editing a newly created workbook.
await new Promise<void>((resolve) => {
if (univerAPI.getCurrentLifecycleStage() >= univerAPI.Enum.LifecycleStages.Steady) {
resolve()
return
}
const listener = univerAPI.addEvent(univerAPI.Event.LifeCycleChanged, ({ stage }) => {
if (stage === univerAPI.Enum.LifecycleStages.Steady) {
listener.dispose()
resolve()
}
})
})
const workbook = univerAPI.getActiveWorkbook()!
const sheet = workbook.getActiveSheet()
sheet.getRange('A1:D4').setValues([
['Item', 'Quantity', 'Unit price', 'Amount'],
['Seats', 2, 25, '=B2*C2'],
['Support', 1, 100, '=B3*C3'],
['Total', '', '', '=SUM(D2:D3)'],
])
// An application control or agent can make the same edit.
sheet.getRange('B2').setValue(4)
univerAPI.getFormula().onCalculationResultApplied().then(() => {
console.log(sheet.getRange('D4').getValue()) // 200
localStorage.setItem('quotation', JSON.stringify(workbook.save()))
})
Two details are worth noticing. First, the lifecycle wait: write before the workbook reaches the Steady stage and formulas may not be wired up yet. That is the kind of thing an agent tool wrapper must handle once, centrally. Second, calculation is asynchronous; you read results after onCalculationResultApplied() resolves, not right after setValue().
Restoring is one call: univerAPI.createWorkbook(JSON.parse(saved)). The snapshot is Univer’s own JSON format (IWorkbookData), not XLSX. Your app owns storage.
The event system is useful for guardrails. Each plugin contributes typed events on univerAPI.Event, and BeforeCommandExecute can inspect and cancel a command before it runs. If you let an agent loose on a workbook a person is also using, that hook is where you would block, say, deleting a protected sheet.
Headless in Node.js
The Headless guide shows the same engine with no UI. Install the content packages:
npm install @univerjs/core @univerjs/engine-render @univerjs/engine-formula \
@univerjs/docs @univerjs/sheets @univerjs/sheets-formula @univerjs/sheets-numfmt
Then register the content plugins (no *-ui packages) and get the same Facade API:
import { LocaleType, mergeLocales, Univer } from '@univerjs/core'
import { FUniver } from '@univerjs/core/facade'
import { UniverDocsPlugin } from '@univerjs/docs'
import { UniverFormulaEnginePlugin } from '@univerjs/engine-formula'
import { UniverRenderEnginePlugin } from '@univerjs/engine-render'
import { UniverSheetsPlugin } from '@univerjs/sheets'
import { UniverSheetsFormulaPlugin } from '@univerjs/sheets-formula'
import { UniverSheetsNumfmtPlugin } from '@univerjs/sheets-numfmt'
import SheetsEnUS from '@univerjs/sheets/locale/en-US'
import '@univerjs/engine-formula/facade'
import '@univerjs/sheets/facade'
import '@univerjs/sheets-formula/facade'
import '@univerjs/sheets-numfmt/facade'
const univer = new Univer({
locale: LocaleType.EN_US,
locales: { [LocaleType.EN_US]: mergeLocales(SheetsEnUS) },
})
univer.registerPlugin(UniverRenderEnginePlugin)
univer.registerPlugin(UniverFormulaEnginePlugin)
univer.registerPlugin(UniverDocsPlugin)
univer.registerPlugin(UniverSheetsPlugin)
univer.registerPlugin(UniverSheetsFormulaPlugin)
univer.registerPlugin(UniverSheetsNumfmtPlugin)
const univerAPI = FUniver.newAPI(univer)
univerAPI.createWorkbook({})
Headless Univer can create or load a workbook, read and write cells and formatting, change rows and columns, calculate formulas and save a snapshot. The docs are candid about the edges: filtering, sorting, validation, pivot tables and charts work only when the matching content plugins are registered; changing chart data does not render the chart; Office file conversion needs the commercial Server SDK; screenshots need a rendering runtime. The example still depends on @univerjs/engine-render even though it never mounts a Canvas. Headless Univer requires Node.js 18.17.0 or newer.
For an agent backend this is the useful mode: a tool server can load a snapshot, apply the model’s edits, recalculate, return computed values and save. You would write that tool layer yourself in the open-source edition; the AI SDK is dream-num’s paid version of it.
What is free and what is not
The vendor’s own FAQ answers “Is Univer free?” with “Partly.” From univer.ai/pricing as of November 22, 2026:
| Plan | Price | Limits |
|---|---|---|
| Open-source core | Free, Apache-2.0, commercial use allowed | Sheets and Docs editing, formulas, headless content ops; no XLSX import/export, charts, pivot tables, printing or collaboration |
| Freemium (commercial SDK) | $0, development and testing only | All Office editing features, watermarks, 3 collaborative editing connections, 10 watermark-free exports per month |
| Business | From $99/month or from $1,000/year | 25+ editing connections, 5,000+ exports/month, complete Web, Server and AI SDK, one main domain plus subdomains, 1–12 month terms, no auto-renewal |
| Enterprise | Custom | Unlimited connections and exports, distributed deployment |
Some terms are friendlier than usual for commercial SDKs: pricing is by capacity, not seats or documents; licenses are validated locally, “with no online license check and no telemetry at runtime”; and if a license lapses, the SDK drops back to Freemium limits rather than breaking, with documents staying in your environment. A multi-tenant SaaS that gives each customer a subdomain needs one license.
Community reactions
Univer’s 2024 Hacker News launch (178 points, April 2024) set the tone for the criticism that still applies. Commenters zeroed in on “(Pro feature)” labels next to collaboration and printing, two reported demo crashes, and others asked why not LibreOffice or ONLYOFFICE. Those crash reports are two and a half years and dozens of releases old, so treat them as history, not current bugs.
The newer reaction is from builders. GenOffice, Genspark’s open-source AI office suite, builds its Sheets app on the open-source Univer core and extends it heavily (we covered it in our GenOffice review). The Build with Neej newsletter’s November 20 roundup reports running the quick start at v1.5.2: it loaded six rows with revenue formulas, a SUM and a SUMIF, changed one cell from code, and says the sheet recalculated correctly, with the install taking about 15 seconds. That is a third-party result, not ours.
Honest limitations
- No Excel files in the free tier. XLSX, DOCX and PPTX import and export sit in the commercial Server SDK. The open-source path persists Univer JSON snapshots. For many agent use cases, getting an
.xlsxout is the whole point. - Collaboration is paid. Real-time multi-user editing, revision history and the OT server are commercial. The free core is single-user unless you build sync yourself.
- Charts and pivot tables are paid, which rules out a lot of “build me a dashboard” agent tasks on the free edition.
- Weekly releases, lockstep versions. Every
@univerjs/*package must match; five releases in three weeks means frequent upgrades. The project publishes an API Stability Policy; read it before depending on internals. - Browser floor. It compiles for Chrome 88 and lists Edge 88+, Firefox 90+, Safari 14.1+ and Electron 12+. It needs
Intl.Segmenter(polyfill it where missing). The view layer is React 18 and supports React 19. - Package sprawl. A modest setup in Plugin Mode is 14 packages plus CSS and locale files. Presets help, but debugging spans many packages.
- Demos overstate the free edition. The README itself notes that its demo videos include commercial features. Check the feature comparison with its “Open source only” filter before you commit.
- Not run by us (see above), so this review cannot speak to install friction, memory use or recalculation speed on large sheets.
Univer vs the alternatives
| Need | Better fit |
|---|---|
| Embeddable spreadsheet with a real formula engine, Apache-2.0, you own storage | Univer open-source core |
| Same, plus XLSX round-trip, charts, collaboration, and you can pay | Univer Business, or ONLYOFFICE Docs (AGPL-3.0 server, commercial license if you can’t comply) |
| A data grid with spreadsheet feel, not a full office engine | Handsontable (commercial use needs a paid license) or AG Grid |
Agent only needs to write .xlsx files, no live UI | openpyxl, SheetJS or ExcelJS, far simpler |
| A full desktop office suite | LibreOffice, or GenOffice for an AI-first one |
Verdict
Univer’s open-source core is a serious piece of engineering: a plugin-based spreadsheet and document engine with a mature formula engine, a clean command/undo model and a Facade API that works the same in the browser and headless in Node. For an agent product that needs a live, inspectable spreadsheet a human and a model can both edit, it is one of the best free foundations available in late 2026.
Go in with clear eyes about the split. The features most agent workflows eventually want, Excel import and export, charts, pivots, collaboration and the agent-ready AI SDK, are commercial. The $99/month entry price is modest for a business, and the licensing terms are reasonable. But “open-source alternative to Google Sheets” is not what this repository is. It is an open-source spreadsheet engine with a commercial office suite built on top.
Use it if you are building a product that needs an embedded sheet with formulas and you control persistence. Skip it if your agent just needs to produce Excel files, or you need free collaboration.
FAQ
Is Univer free and open source?
Partly. The core in dream-num/univer is Apache-2.0 and free for commercial use: Sheets and Docs editing, formulas, filtering, sorting, validation, conditional formatting, comments and headless content operations. Charts, pivot tables, printing, Office file conversion, real-time collaboration, the Server SDK and the AI SDK are commercial; production licenses start at $99 per month as of November 22, 2026.
Can Univer import and export Excel (.xlsx) files?
Not in the open-source edition. XLSX, DOCX and PPTX conversion is part of the commercial Server SDK. The free core saves and loads Univer’s own JSON snapshots via workbook.save() and createWorkbook(snapshot).
Can Univer run on a server without a browser?
Yes. Headless Univer runs in Node.js 18.17.0 or newer using the content plugins without any UI packages. It can create and load workbooks, edit cells and formatting, calculate formulas and save snapshots. Rendering charts or screenshots needs a separate rendering runtime, and file conversion needs the Server SDK.
How do AI agents use Univer?
Through the same Facade API application code uses: getRange().setValues(), getValue(), getFormula() and events like BeforeCommandExecute, which can cancel an edit. Your app supplies the model and the tool layer. Dream-num’s commercial AI SDK adds structured inspection, screenshots, layout linting and Worktree drafts for human review, and there are ready-made integrations including Univer CLI, Univer Workspace and a Univer Office plugin for OpenClaw.
Is Univer the same as Luckysheet?
It is its successor from the same team. Luckysheet’s GitHub repository is archived with the description “Luckysheet upgraded to Univer.” Univer is a rewrite with a plugin architecture, not a drop-in upgrade.
Sources
- dream-num/univer on GitHub: README, stars, forks, license, open issues
- Univer v1.6.0 release notes
- Headless Univer guide (Node.js)
- Univer Office SDK pricing and licensing FAQ
- Univer feature comparison (open source vs commercial)
- API Stability Policy
- Univer Workspace and Univer CLI
- Luckysheet (archived)
- Hacker News launch discussion, April 2024
- Build with Neej: 5 GitHub repos that broke out this week (Nov 14 to 20)