{"id":46837,"library":"xtcocotools","title":"xtcocotools","description":"Extended COCO API (xtcocotools) is a fork of the original COCO API with enhanced functionality for keypoint detection and human pose estimation. Current version: 1.14.3. Release cadence is irregular, primarily updated for bug fixes and compatibility improvements.","status":"active","version":"1.14.3","language":"python","source_language":"en","source_url":"https://github.com/jin-s13/xtcocoapi","tags":["coco","keypoint","pose-estimation","computer-vision"],"install":[{"cmd":"pip install xtcocotools","lang":"bash","label":"PyPI installation"},{"cmd":"pip install git+https://github.com/jin-s13/xtcocoapi.git","lang":"bash","label":"Install from source"}],"dependencies":[{"reason":"Conflict in namespace: installing both pycocotools and xtcocotools can cause import errors due to overlapping .pyd files.","package":"pycocotools","optional":false},{"reason":"Required for building from source if no pre-built wheel is available.","package":"Cython","optional":true},{"reason":"Core dependency for array operations.","package":"numpy","optional":false}],"imports":[{"note":"xtcocotools is a fork; mixing imports from pycocotools leads to version mismatch or missing keypoint methods.","wrong":"from pycocotools.coco import COCO","symbol":"COCO","correct":"from xtcocotools.coco import COCO"},{"note":"","wrong":"","symbol":"COCOeval","correct":"from xtcocotools.cocoeval import COCOeval"},{"note":"","wrong":"","symbol":"COCOkeypointAPI","correct":"from xtcocotools.coco import COCOkeypointAPI"},{"note":"Same as above - namespace conflict.","wrong":"from pycocotools import mask","symbol":"mask","correct":"from xtcocotools import mask as maskUtils"}],"quickstart":{"code":"from xtcocotools.coco import COCO\nfrom xtcocotools.cocoeval import COCOeval\n\n# Initialize COCO API for keypoint annotations\ncoco = COCO('annotations/person_keypoints_train2017.json')\n# Get category IDs\ncat_ids = coco.getCatIds(catNms=['person'])\nimg_ids = coco.getImgIds(catIds=cat_ids)\nprint(f'Found {len(img_ids)} images')","lang":"python","description":"Quick start: load a COCO keypoint annotation file and list image IDs for the 'person' category."},"warnings":[{"fix":"Uninstall pycocotools: pip uninstall pycocotools -y; then install xtcocotools.","message":"Do not install pycocotools alongside xtcocotools. Both share the same top-level module name in compiled extensions, causing cryptic crashes like ImportError or undefined symbols.","severity":"breaking","affected_versions":"all"},{"fix":"Install via conda if available, or use a precompiled wheel from PyPI with Python 3.6+.","message":"The COCO API uses .pyd files on Windows or .so on Linux; if you build from source, ensure you have Cython and a C++ compiler installed. Pre-built wheels may not be available for all platforms.","severity":"gotcha","affected_versions":">=1.0"},{"fix":"Use COCO() object and COCOeval() with iouType='keypoints' instead.","message":"xtcocotools.coco.COCOkeypointAPI is deprecated in newer versions. Use COCO methods directly or migrate to the standard COCOeval keypoint evaluation.","severity":"deprecated","affected_versions":">=1.12"}],"env_vars":null,"search_vec":"'1.14.3':26 'api':4,13 'bug':34 'cadenc':28 'coco':3,12,39 'compat':37 'comput':45 'computer-vis':44 'current':24 'detect':19 'enhanc':15 'estim':23,43 'extend':2 'fix':35 'fork':8 'function':16 'human':21 'improv':38 'irregular':30 'keypoint':18,40 'origin':11 'pose':22,42 'pose-estim':41 'primarili':31 'releas':27 'updat':32 'version':25 'vision':46 'xtcocotool':1,5","created_at":"2026-06-07T13:01:52.520616+00:00","updated_at":"2026-06-07T13:01:52.520616+00:00","problems":{"verify_error":"× Failed to build `xtcocotools==1.14.3`\n  ├─▶ The build backend returned an error\n  ╰─▶ Call to `setuptools.build_meta:__legacy__.build_wheel` failed (exit\n      status: 1)\n\n      [stderr]\n      Traceback (most recent call last):\n        File \"<string>\", line 14, in <module>\n        File\n      \"/hom"},"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/jin-s13/xtcocoapi","github":"https://github.com/jin-s13/xtcocoapi","docs":null,"changelog":null,"pypi":null,"npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["ai-ml"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"install_fail","verified_at":"2026-06-29","last_verified":"2026-06-29","next_check":"2026-07-06","install_tag":null}}