Skip to content

Expanse documentation

Expanse is a spreadsheet you already know how to use, with an agent you don’t. The Grid is a Grid: cells, formulas, ranges, charts. What’s new is being able to ask for what you want in plain language and get formulas written into cells you can read, edit, and audit.

These docs cover what you can actually do in a cell today.

  • AI completions: as you type a formula, Expanse predicts the rest from the surrounding cells. Press Tab to accept.
  • Canvas mode: turn a sheet region into an interactive kanban board, gallery, dashboard, calendar, or heat map from a plain-language prompt.
  • Collaboration: sync a workbook live between people through a self-hosted or hosted collab server.
  • Self-hosting: run the Expanse backend on your own infrastructure with Docker Compose.

The reference section is generated straight from the engine, so it tracks the code as features land:

  • Functions: every Excel-compatible function Expanse evaluates, with signatures, argument notes, and examples for the curated set.
  • Python in cells: the sandboxed Python runtime, its built-ins, the auto-imported math module, array spilling, and the sandbox boundaries.
  • SQL in cells: query connected Parquet and PostgreSQL sources with Apache DataFusion, and spill the results into the grid.
  • Agent tools: the workbook tools every Expanse agent can call, with parameters and which ones write to the sheet.

Most cells hold an Excel formula, but a cell can also run other engines:

  • =PY(…) runs sandboxed Python.
  • =SQL(…) runs SQL over connected Parquet and PostgreSQL sources via Apache DataFusion.
  • =AI(…) and the AI.* family prompt an LLM and write the answer into the cell.