Skip to content

tutorial_image_detection.ipynb fails on Windows: Unix-only shell command and missing COCO dataset setup instructions #612

Description

@ashishsoni-ai

While completing the tutorial_image_detection.ipynb walkthrough on Windows, I hit two issues that block the notebook from running end-to-end out of the box:

1. !mkdir -p is Unix-only

The second cell uses:

!mkdir -p local/data/models
!mkdir -p local/outputs

-p is not a valid flag for Windows cmd.exe (which Jupyter shells out to by default on Windows), so this cell fails with SyntaxError: unexpected character after line continuation character.

2. COCO dataset cell has placeholder paths with no setup guidance

The dataset-loading cell expects:

img_dir = "<PATH_TO_COCO_VAL2017_IMAGES>"
ann_file = "<PATH_TO_COCO_INSTANCES_VAL2017_JSON>"

but there's no instruction anywhere in the notebook on how to obtain COCO val2017 data, so new contributors have no path forward without external research.

Proposed fix

  • Replace !mkdir -p with a cross-platform os.makedirs(..., exist_ok=True) call.
  • Add a cell (or a linked script) that downloads and extracts COCO val2017 images + annotations automatically, so the notebook is fully runnable without manual dataset hunting.

I've already implemented and tested both fixes locally on Windows and I'm happy to open a PR.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions