{"id":24727091,"url":"https://github.com/megvii-basedetection/cvpods","last_synced_at":"2025-04-05T00:04:23.544Z","repository":{"id":41056213,"uuid":"318124806","full_name":"Megvii-BaseDetection/cvpods","owner":"Megvii-BaseDetection","description":"All-in-one Toolbox for Computer Vision Research.","archived":false,"fork":false,"pushed_at":"2023-03-10T10:05:26.000Z","size":2931,"stargazers_count":651,"open_issues_count":35,"forks_count":78,"subscribers_count":28,"default_branch":"master","last_synced_at":"2025-03-28T23:02:52.614Z","etag":null,"topics":["3d","classification","computer-vision","cvpods","detection","keypoints","pytorch","research","segmentation","self-supervised-learning"],"latest_commit_sha":null,"homepage":"https://cvpods.readthedocs.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Megvii-BaseDetection.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2020-12-03T08:26:57.000Z","updated_at":"2025-03-12T08:47:19.000Z","dependencies_parsed_at":"2024-01-07T17:21:29.611Z","dependency_job_id":null,"html_url":"https://github.com/Megvii-BaseDetection/cvpods","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Megvii-BaseDetection%2Fcvpods","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Megvii-BaseDetection%2Fcvpods/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Megvii-BaseDetection%2Fcvpods/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Megvii-BaseDetection%2Fcvpods/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Megvii-BaseDetection","download_url":"https://codeload.github.com/Megvii-BaseDetection/cvpods/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247266563,"owners_count":20910836,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["3d","classification","computer-vision","cvpods","detection","keypoints","pytorch","research","segmentation","self-supervised-learning"],"created_at":"2025-01-27T14:57:48.919Z","updated_at":"2025-04-05T00:04:23.516Z","avatar_url":"https://github.com/Megvii-BaseDetection.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=center\u003e\u003cimg src=\".github/cvpods_logo.png\" width=\"400\" \u003e\u003cdiv align=left\u003e\n\n[![cvpods compliant](https://img.shields.io/badge/cvpods-master-brightgreen)](https://github.com/Megvii-BaseDetection/cvpods)\n![ci](https://github.com/Megvii-BaseDetection/cvpods/workflows/build/badge.svg?branch=master)\n\nWelcome to **cvpods**, a versatile and efficient codebase for many computer vision tasks: classification, segmentation, detection, self-supervised learning, keypoints and 3D(classification / segmentation / detection / representation learing), etc. The aim of cvpods is to achieve efficient experiments management and smooth tasks-switching.\n\n\u003cdiv align=center\u003e\u003cimg src=\".github/cvpods_tasks.png\"\u003e\u003cdiv align=left\u003e\n\n\u003e  Each sub-image denotes a task. All images are from search engine.\n\n## Table of Contents\n\n- [Changelog](#changelog)\n- [Install](#install)\n- [Usage](#usage)\n\t- [Get started](#get-start)\n\t- [Step-by-step tutorial](#tutorials)\n- [Model Zoo](#model-zoo)\n- [Contributing](#contributing)\n- [License](#license)\n- [Citation](#citation)\n- [Acknowledgement](#acknowledgement)\n\n## Changelog \n* Dec. 03, 2020: cvpods v0.1 released.\n\n## Install\n\n### Requirements\n\n* Linux with Python ≥ 3.6\n* PyTorch ≥ 1.3 and torchvision that matches the PyTorch installation. You can install them together at pytorch.org to make sure of this\n* OpenCV is optional and needed by demo and visualization\n\n### Build cvpods from source \n\n**Make sure GPU is available on your local machine.**\n\n```shell\n# Install cvpods with GPU directly \npip install 'git+https://github.com/Megvii-BaseDetection/cvpods.git' --user\n\n# Or, to install it with GPU from a local clone:\ngit clone https://github.com/Megvii-BaseDetection/cvpods.git\npip install -e cvpods --user \n\n# Or, to build it without GPU from a local clone:\nFORCE_CUDA=1 pip install -e cvpods --user\n\n```\n\n## Usage\nHere we demonstrate the basic usage of cvpods (Inference \u0026 Train). For more features of cvpods, please refer to our documentation or provided tutorials.\n\n### Get Start \nHere we use coco object detection task as an example.\n```\n# Preprare data path\nln -s /path/to/your/coco/dataset datasets/coco\n\n# Enter a specific experiment dir \ncd playground/retinanet/retinanet.res50.fpn.coco.multiscale.1x\n\n# Train\npods_train --num-gpus 8\n# Test\npods_test --num-gpus 8 \\\n    MODEL.WEIGHTS /path/to/your/save_dir/ckpt.pth # optional\n    OUTPUT_DIR /path/to/your/save_dir # optional\n\n# Multi node training\n## sudo apt install net-tools ifconfig\npods_train --num-gpus 8 --num-machines N --machine-rank 0/1/.../N-1 --dist-url \"tcp://MASTER_IP:port\"\n```\n\n### Tutorials\n\nWe provide a detailed tutorial, which covers introduction, usage, and extend guides in [cvpods_tutorials](https://github.com/Megvii-BaseDetection/cvpods/blob/master/docs/tutorials/cvpods%20tutorials.ipynb). For all API usages, please\nrefer to our [documentation](https://cvpods.readthedocs.io/).\n\n## Model ZOO \n\nFor all the models supported by cvpods, please refer to [MODEL_ZOO](https://github.com/Megvii-BaseDetection/cvpods/blob/master/playground/README.md). We provide 50+ methods across ~15 dataset and ~10 computer vision tasks. cvpods has also supported many research projects of MEGVII Research.\n\n### Projects based on cvpods\n\u003e List is sorted by names.\n* [AutoAssign](https://github.com/Megvii-BaseDetection/AutoAssign)\n* [BorderDet](https://github.com/Megvii-BaseDetection/BorderDet)\n* [DeFCN](https://github.com/Megvii-BaseDetection/DeFCN)\n* [DisAlign](https://github.com/Megvii-BaseDetection/DisAlign)\n* [DynamicHead](https://github.com/StevenGrove/DynamicHead)\n* [DynamicRouting](https://github.com/Megvii-BaseDetection/DynamicRouting)\n* [LearnableTreeFilterV2](https://github.com/StevenGrove/LearnableTreeFilterV2)\n* [LLA](https://github.com/Megvii-BaseDetection/LLA)\n* [OTA](https://github.com/Megvii-BaseDetection/OTA)\n* [SelfSup](https://github.com/poodarchu/SelfSup)\n* [YOLOF](https://github.com/megvii-model/YOLOF)\n\n\n## Contributing \nAny kind of contributions (new models / bug report / typo / docs) are welcomed. Please refer to [CONTRIBUTING](CONTRIBUTING.md) for more details.\n\n## License\n\n[Apache v2](LICENSE) © Base Detection \n\n## Acknowledgement and special thanks\n\ncvpods adopts many components (e.g. network layers) of Detectron2, while cvpods has many advantanges in task support, speed, usability, etc. For more details about official detectron2, please check [DETECTRON2](https://github.com/facebookresearch/detectron2/blob/master/README.md)\n\n## Citing cvpods\n\nIf you are using cvpods in your research or wish to refer to the baseline results published in this repo, please use the following BibTeX entry.\n\n```BibTeX\n@misc{zhu2020cvpods,\n  title={cvpods: All-in-one Toolbox for Computer Vision Research},\n  author={Zhu*, Benjin and Wang*, Feng and Wang, Jianfeng and Yang, Siwei and Chen, Jianhu and Li, Zeming},\n  year={2020}\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmegvii-basedetection%2Fcvpods","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmegvii-basedetection%2Fcvpods","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmegvii-basedetection%2Fcvpods/lists"}