{"record":{"id":"8da5fa57dea56b5e","repo":"open-mmlab/mmdetection","slug":"mmlvis-is-deprecated-please-install-official-lvis","errorCode":null,"errorMessage":"mmlvis is deprecated, please install official lvis-api by \"pip install git+https://github.com/lvis-dataset/lvis-api.git\"","messagePattern":"mmlvis is deprecated, please install official lvis-api by \"pip install git\\+https://github\\.com/lvis-dataset/lvis-api\\.git\"","errorType":"console","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"mmdet/datasets/lvis.py","lineNumber":282,"sourceCode":"         'wig', 'wind_chime', 'windmill', 'window_box_(for_plants)',\n         'windshield_wiper', 'windsock', 'wine_bottle', 'wine_bucket',\n         'wineglass', 'wing_chair', 'blinder_(for_horses)', 'wok', 'wolf',\n         'wooden_spoon', 'wreath', 'wrench', 'wristband', 'wristlet', 'yacht',\n         'yak', 'yogurt', 'yoke_(animal_equipment)', 'zebra', 'zucchini'),\n        'palette':\n        None\n    }\n\n    def load_data_list(self) -> List[dict]:\n        \"\"\"Load annotations from an annotation file named as ``self.ann_file``\n\n        Returns:\n            List[dict]: A list of annotation.\n        \"\"\"  # noqa: E501\n        try:\n            import lvis\n            if getattr(lvis, '__version__', '0') >= '10.5.3':\n                warnings.warn(\n                    'mmlvis is deprecated, please install official lvis-api by \"pip install git+https://github.com/lvis-dataset/lvis-api.git\"',  # noqa: E501\n                    UserWarning)\n            from lvis import LVIS\n        except ImportError:\n            raise ImportError(\n                'Package lvis is not installed. Please run \"pip install git+https://github.com/lvis-dataset/lvis-api.git\".'  # noqa: E501\n            )\n        with get_local_path(\n                self.ann_file, backend_args=self.backend_args) as local_path:\n            self.lvis = LVIS(local_path)\n        self.cat_ids = self.lvis.get_cat_ids()\n        self.cat2label = {cat_id: i for i, cat_id in enumerate(self.cat_ids)}\n        self.cat_img_map = copy.deepcopy(self.lvis.cat_img_map)\n\n        img_ids = self.lvis.get_img_ids()\n        data_list = []\n        total_ann_ids = []\n        for img_id in img_ids:","sourceCodeStart":264,"sourceCodeEnd":300,"githubUrl":"https://github.com/open-mmlab/mmdetection/blob/cfd5d3a985b0249de009b67d04f37263e11cdf3d/mmdet/datasets/lvis.py#L264-L300","documentation":"Warning from LVIS v1 dataset load_data_list: the installed `lvis` package looks like the deprecated 'mmlvis' fork (version >= '10.5.3' heuristic), and official lvis-api is recommended instead.","triggerScenarios":"Building LVISV05Dataset/LVISV1Dataset when the mmlvis fork (with inflated 10.x version) provides the `lvis` module.","commonSituations":"Legacy mmdet 2.x envs that installed mmlvis; fork diverges from official lvis-api and can break evaluation.","solutions":["pip uninstall mmlvis && pip install git+https://github.com/lvis-dataset/lvis-api.git","Reinstall from updated mmdet extra requirements"],"exampleFix":"# before\npip install mmlvis\n# after\npip uninstall mmlvis\npip install git+https://github.com/lvis-dataset/lvis-api.git","handlingStrategy":"validation","validationCode":"import lvis\nif getattr(lvis, '__version__', '0') >= '10.5.3':\n    print('mmlvis fork detected; install official lvis-api')","typeGuard":null,"tryCatchPattern":"import warnings\nwith warnings.catch_warnings():\n    warnings.filterwarnings('ignore', message='mmlvis is deprecated')\n    from mmdet.datasets.lvis import LVISV1Dataset","preventionTips":["Install official lvis-api from the LVIS GitHub","Audit legacy envs for forked packages"],"tags":["python","warning","lvis","deprecated-dependency","dataset"],"backgroundTag":"deprecated-package-fork","analyzedSha":"cfd5d3a985b0249de009b67d04f37263e11cdf3d","analyzedAt":"2026-08-27T20:54:20.183Z","schemaVersion":2},"datasetVersion":"2026-08-28T00:17:15.603Z"}