Skip to main content

Import and export projects

Hex supports two different file formats for importing and exporting your projects outside of Hex.

Importing existing Jupyter Notebooks provides a convenient way to migrate existing work into Hex, while exporting Hex projects provides a way to enable versioning workflows, as well as the ability for teams to own their code, and make bulk changes as required.

Hex lets you import and export projects in two different file formats:

  • Jupyter Notebooks (.ipnyb file): You can import an existing Jupyter Notebook file as a new Hex project and export existing Hex projects as Jupyter Notebooks. Note that some Hex-specific functionality, like SQL cells or Input paramters, will break when exporting projects as a Jupyter Notebook.
  • Hex file format (.yaml file): The Hex file format represents the logic of your entire project (including the layout of an app) as a YAML file. It’s fully compatible with all features of Hex, and does not contain any potentially sensitive outputs of your project.

Where possible, we recommend using the Hex file format for importing and exporting projects. This is because Hex is able to “round trip” projects with this format (i.e. export a project, and then re-import it as an identical project), it is easier to perform code review on due to the human-readable nature of the YAML format, and project outputs are excluded from the file.

tip

🆕 The Hex file format is a new feature. If you have feedback on the implementation, we’re all ears.

Import projects#

To import an existing Jupyter Notebook or Hex file as a project, select the Import button from the home page and upload either a .ipnyb or .yaml file.

Import a new version of a project#

tip

This is only available for the Hex file format as Hex relies on information encoded in the Hex file format to track changes to a project.

Import a .yaml file version of a Hex project as a new version.

To import a Hex project as a new version of an existing project, visit the History & Versions sidebar, and choose Import a version from the + Version drop down menu.

Export projects#

tip

Workspaces on the Team plan or higher can sync projects with a GitHub repo. Read the GitHub sync docs for more information!

To export an existing Hex project to either file format, select Export from the dropdown menu in the project title.

Export a Hex project as a `.yaml` file.