Primary competition visual

Adaptation Atlas Data Storytelling Challenge (Track 5): Rainfall

Helping Africa
$1 500 USD
Reveal coming soon!
Data visualisation
Data storytelling
Data analysis
Python
Javascript
GIS
Observable
HTML
Markdown
162 joined
25 active
Starti
Sep 05, 25
Closei
Nov 03, 25
Reveali
Nov 28, 25
User avatar
MuhammadQasimShabbeer
Engmatix
Unexpected Error While Uploading .HTML Notebook on Zindi
Help Ā· 3 Nov 2025, 05:37 Ā· 2

I recently created a Python notebook and converted it into an .html file on Kaggle. I tried to upload the .html version of my notebook to Zindi for the challenge, but I’m encountering this message:

“An unexpected error has occurred during scoring, our team has been alerted to this issue.”

Here’s what I did:

  • I developed and tested my notebook on Kaggle.
  • I used the standard Python environment and exported my notebook using: jupyter nbconvert --to html my_notebook.ipynb
  • The file uploads fine on Zindi, but as soon as I try to view or submit it, I get the error message above.

I’m not sure if:

  • if the conversion from .ipynb to .html causes a formatting issue, or
  • if there’s a temporary scoring system error on the site.

Has anyone else experienced this issue? If anyone from the Zindi team is reading this — could you please confirm if .html notebooks are supported for upload and viewing? @zindi

Discussion 2 answers
User avatar
Helkias
University of Abomey-Calavi

Hi there

The error you’re seeing occurs because Zindi does not accept standard .html notebooks exported from Jupyter or Kaggle for this particular challenge.

This competition uses Observable Notebooks, which are based on JavaScript (not Python) and have a completely different notebook format and runtime. That’s why when you upload a regular .html file converted with

jupyter nbconvert --to html the_sub_notebook.ipynb

Zindi’s scoring system cannot read it. It expects an Observable export.

To submit a valid notebook, you must work directly inside Observable and then export it properly using the Observable Notebook Kit tool.

To do it:

  1. Make sure you have a JavaScript runtime installed, such as Node.js (v24+), Deno (v2.2+), or Bun (v1.2+).
  2. Install the Notebook Kit:
npm add @observablehq/notebook-kitor
// OR
deno add npm:@observablehq/notebook-kit@latest

3. Export as .html file using the CLI:

notebook-kit download \
"https://observablehq.com/d/8a953dc1cde63a86" \
> notebook.html 

(Replace the URL with your own Observable notebook link.)

4. Then, upload the generated notebook .html file to Zindi. It will be correctly recognized.

You can find the documentation for the process here : Export Notebooks to HTML with Notebook Kit

3 Nov 2025, 06:07
Upvotes 0
User avatar
Helkias
University of Abomey-Calavi

Hope it helps...