Client-side installation

Install with npm or Yarn

You can install the latest version of HyperFormula with popular packaging managers. Navigate to your project folder and run the following command:

npm:

$ npm install hyperformula

Yarn:

$ yarn add hyperformula

The package will be added to your package.json file and installed to the ./node_modules directory.

Then you can import it into your file like this:

import { HyperFormula } from 'hyperformula';

// your code

Use CDN

Alternatively, you can load HyperFormula from jsDelivr and embed the URL directly in the <script> tag. This way you will make it accessible in the project as a HyperFormula global variable.

Full build will include all the required dependencies:

<script src="https://cdn.jsdelivr.net/npm/hyperformula/dist/hyperformula.full.min.js"></script>

Or you may load just a minimal build and add the dependencies on your own:

<script src="https://cdn.jsdelivr.net/npm/chevrotain@6/lib/chevrotain.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/tiny-emitter@2/dist/tinyemitter.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/hyperformula/dist/hyperformula.min.js"></script>

A useful option when you already use some of them and there is no need to duplicate the dependencies. You can read more about the dependencies of HyperFormula on a dedicated Dependencies page.

Clone from GitHub

If you choose to clone the project or download it from GitHub you will need to build it prior to usage. Check the building section for a full list of commands and their descriptions.

Clone with HTTPS

git clone https://github.com/handsontable/hyperformula.git

Clone with SSH

git clone git@github.com:handsontable/hyperformula.git

Download from GitHub

You can download all resources as a ZIP archive directly from the GitHub repository. Then, you can use one of the above-mentioned methods to install the library.

Set up your coding agent

HyperFormula ships an official Claude skill and machine-readable docs, so your AI coding agent can scaffold, configure, and debug HyperFormula correctly. To install the skill in Claude Code, or to point Cursor, GitHub Copilot, or another agent at the docs, see Set up your coding agent.