# ImageNet Classes
A Python package for managing and retrieving ImageNet-1k (ImageNet2012) class names and mappings.
## Installation
### From PyPI (when published)
```bash
pip install imagenet-classes
```
### From Source
```bash
git clone https://github.com/gonikisgo/imagenet-classes.git
cd imagenet-classes
pip install -e .
```
## Quick Start
```python
from class_mapping import ClassDictionary
# Initialize the class dictionary
class_dict = ClassDictionary()
# Get class name for ImageNet-1k class index 0
class_name = class_dict.get_class_name(0)
print(f"Class 0: {class_name}")
# Get ImageNet21k to ImageNet-1k class mapping
class_1k = class_dict.get_class_1k("n01440764")
print(f"Class 1k mapping: {class_1k}")
# Get custom class name
custom_name = class_dict.get_custom_class_name(0)
print(f"Custom name: {custom_name}")
```
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Support
For support, please open an issue on the [GitHub repository](https://github.com/gonikisgo/imagenet-classes/issues).
Raw data
{
"_id": null,
"home_page": "https://github.com/gonikisgo/imagenet-classes",
"name": "imagenet-classes",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "Nikita Kisel <kiselnik@fel.cvut.cz>",
"keywords": "imagenet, computer-vision, machine-learning, deep-learning, classification",
"author": "Illia Volkov, Nikita Kisel",
"author_email": "Illia Volkov <volkoill@cvut.cz>, Nikita Kisel <kiselnik@fel.cvut.cz>",
"download_url": "https://files.pythonhosted.org/packages/08/3c/7e2629aee1acffa8755f2f1c37e79cea452128bf9e702d16c52846c1cc43/imagenet_classes-0.1.1.tar.gz",
"platform": null,
"description": "# ImageNet Classes\n\nA Python package for managing and retrieving ImageNet-1k (ImageNet2012) class names and mappings.\n\n## Installation\n\n### From PyPI (when published)\n```bash\npip install imagenet-classes\n```\n\n### From Source\n```bash\ngit clone https://github.com/gonikisgo/imagenet-classes.git\ncd imagenet-classes\npip install -e .\n```\n\n## Quick Start\n\n```python\nfrom class_mapping import ClassDictionary\n\n# Initialize the class dictionary\nclass_dict = ClassDictionary()\n\n# Get class name for ImageNet-1k class index 0\nclass_name = class_dict.get_class_name(0)\nprint(f\"Class 0: {class_name}\")\n\n# Get ImageNet21k to ImageNet-1k class mapping\nclass_1k = class_dict.get_class_1k(\"n01440764\")\nprint(f\"Class 1k mapping: {class_1k}\")\n\n# Get custom class name\ncustom_name = class_dict.get_custom_class_name(0)\nprint(f\"Custom name: {custom_name}\")\n```\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Support\n\nFor support, please open an issue on the [GitHub repository](https://github.com/gonikisgo/imagenet-classes/issues).\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Python package for managing and retrieving ImageNet-1k mappings among integer class IDs, string class IDs, and human-readable class names.",
"version": "0.1.1",
"project_urls": {
"Bug Tracker": "https://github.com/gonikisgo/imagenet-classes/issues",
"Documentation": "https://github.com/gonikisgo/imagenet-classes#readme",
"Homepage": "https://github.com/gonikisgo/imagenet-classes",
"Repository": "https://github.com/gonikisgo/imagenet-classes"
},
"split_keywords": [
"imagenet",
" computer-vision",
" machine-learning",
" deep-learning",
" classification"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "332a2cfe317e18118638d35167adf56819809b28e0ecb6687e489d777b25e2e8",
"md5": "1e99f6031016bb692e34e946019fdd07",
"sha256": "1c3e5fba6d3bb0deb5ce1279630aa5eb4a538581f622db51590485b956503db1"
},
"downloads": -1,
"filename": "imagenet_classes-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1e99f6031016bb692e34e946019fdd07",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 369521,
"upload_time": "2025-08-12T11:36:13",
"upload_time_iso_8601": "2025-08-12T11:36:13.134478Z",
"url": "https://files.pythonhosted.org/packages/33/2a/2cfe317e18118638d35167adf56819809b28e0ecb6687e489d777b25e2e8/imagenet_classes-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "083c7e2629aee1acffa8755f2f1c37e79cea452128bf9e702d16c52846c1cc43",
"md5": "9c284f52516d401f22064e4b616785ac",
"sha256": "51f283e62aa7873130f53fd335cd77f1d102a777c2eb5f8a7d037b82da418a4a"
},
"downloads": -1,
"filename": "imagenet_classes-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "9c284f52516d401f22064e4b616785ac",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 371168,
"upload_time": "2025-08-12T11:36:14",
"upload_time_iso_8601": "2025-08-12T11:36:14.648284Z",
"url": "https://files.pythonhosted.org/packages/08/3c/7e2629aee1acffa8755f2f1c37e79cea452128bf9e702d16c52846c1cc43/imagenet_classes-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-12 11:36:14",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "gonikisgo",
"github_project": "imagenet-classes",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "numpy",
"specs": [
[
">=",
"1.19.0"
]
]
}
],
"lcname": "imagenet-classes"
}
JSON
