{"record":{"id":"6bae477c97d4ea39","repo":"huggingface/pytorch-image-models","slug":"please-install-webdataset-0-2-x-package-pip-insta","errorCode":null,"errorMessage":"Please install webdataset 0.2.x package `pip install git+https://github.com/webdataset/webdataset`.","messagePattern":"Please install webdataset 0\\.2\\.x package `pip install git\\+https://github\\.com/webdataset/webdataset`\\.","errorType":"error_code","errorClass":"RuntimeError","httpStatus":null,"severity":"error","filePath":"timm/data/readers/reader_wds.py","lineNumber":284,"sourceCode":"            name: Optional[str] = None,\n            split: str = 'train',\n            is_training: bool = False,\n            num_samples: Optional[int] = None,\n            batch_size: int = 1,\n            repeats: int = 0,\n            seed: int = 42,\n            class_map: Optional[dict] = None,\n            input_key: str = 'jpg;png;webp',\n            input_img_mode: str = 'RGB',\n            target_key: str = 'cls',\n            target_img_mode: str = '',\n            filename_key: str = 'filename',\n            sample_shuffle_size: Optional[int] = None,\n            sample_initial_size: Optional[int] = None,\n    ):\n        super().__init__()\n        if wds is None:\n            raise RuntimeError(\n                'Please install webdataset 0.2.x package `pip install git+https://github.com/webdataset/webdataset`.')\n        self.root = root\n        self.is_training = is_training\n        self.batch_size = batch_size\n        self.repeats = repeats\n        self.common_seed = seed  # a seed that's fixed across all worker / distributed instances\n        self.shard_shuffle_size = 500\n        self.sample_shuffle_size = sample_shuffle_size or SAMPLE_SHUFFLE_SIZE\n        self.sample_initial_size = sample_initial_size or SAMPLE_INITIAL_SIZE\n\n        self.input_key = input_key\n        self.input_img_mode = input_img_mode\n        self.target_key = target_key\n        self.filename_key = filename_key\n        self.key_ext = '.JPEG'  # extension to add to key for original filenames (DS specific, default ImageNet)\n\n        self.info = _load_info(self.root)\n        self.split_info = _parse_split_info(split, self.info)","sourceCodeStart":266,"sourceCodeEnd":302,"githubUrl":"https://github.com/huggingface/pytorch-image-models/blob/9a5261e31b3b5128526eb2658333b4c0a54464ae/timm/data/readers/reader_wds.py#L266-L302","documentation":"ReaderWds requires the third-party webdataset package; the import failed (wds is None), so __init__ raises immediately with install instructions pinned to the 0.2.x line that timm's reader is built against.","triggerScenarios":"Constructing ReaderWds (directly or via create_dataset(..., dataset_name='wds')) in an environment where webdataset is not installed or failed to import.","commonSituations":"Fresh timm install without the extras; a broken webdataset install (dependency conflict, partial pip failure); installing webdataset 0.1.x/other incompatible majors that fail to import alongside the installed timm.","solutions":["pip install git+https://github.com/webdataset/webdataset (as the message suggests) or pip install 'webdataset>=0.2,<0.3'.","If install fails, check for dependency conflicts (e.g. braceexpand, msgpack) and retry in a clean venv.","Verify with python -c \"import webdataset; print(webdataset.__version__)\"."],"exampleFix":"pip install 'webdataset>=0.2,<0.3'\n# then retry creating the reader","handlingStrategy":"fallback","validationCode":"try:\n    import webdataset as wds\nexcept ImportError:\n    raise SystemExit('pip install webdataset>=0.2,<0.3')","typeGuard":null,"tryCatchPattern":"try:\n    reader = ReaderWds(root, split='train')\nexcept RuntimeError as e:\n    if 'webdataset' in str(e):\n        subprocess.check_call([sys.executable,'-m','pip','install','webdataset>=0.2,<0.3'])\n    raise","preventionTips":["Declare webdataset in your environment/requirements when using wds readers.","Pin the 0.2.x line to match timm's reader.","Fail fast at startup with an import check."],"tags":["timm","webdataset","missing-dependency","pip"],"backgroundTag":"missing-optional-dependency","analyzedSha":"9a5261e31b3b5128526eb2658333b4c0a54464ae","analyzedAt":"2026-08-27T02:34:25.417Z","schemaVersion":2},"datasetVersion":"2026-08-27T03:17:27.898Z"}