pybioclip
Command line tool and python package to simplify using BioCLIP (current and earlier versions), including for taxonomic or other label prediction on (and thus annotation or labeling of) images, as well as for generating semantic embeddings for images. No particular understanding of ML or computer vision is required to use it. It also implements a number of performance optimizations for batches of images or custom class lists, which should be particularly useful for integration into computational workflows.
Documentation
See the pybioclip documentation website for requirements, installation instructions, and tutorials.
License
pybioclip is distributed under the terms of the MIT license.
Citation
To cite this repository, please use the citation provided by Cite this repository in the sidebar, which uses the information in the CITATON.cff file. If you need a citation with a version-specific DOI, you can obtain this by following the Zenodo DOI badge at the top of this file.
Unless you selected (via --model) a model different from the default (which is now BioCLIP 2), please also cite the BioCLIP 2 paper:
@inproceedings{gu2025bioclip,
title={Bio{CLIP} 2: Emergent Properties from Scaling Hierarchical Contrastive Learning},
author={Jianyang Gu and Samuel Stevens and Elizabeth G Campolongo and Matthew J Thompson and Net Zhang and Jiaman Wu and Andrei Kopanev and Zheda Mai and Alexander E. White and James Balhoff and Wasila Dahdul and Daniel Rubenstein and Hilmar Lapp and Tanya Berger-Wolf and Wei-Lun Chao and Yu Su},
booktitle={The Thirty-ninth Annual Conference on Neural Information Processing Systems},
year={2025},
url={https://openreview.net/forum?id=yPC9zmkQgG}
}
If you selected the original BioCLIP model (using --model), please cite the original BioCLIP paper:
@inproceedings{stevens2024bioclip,
title = {{B}io{CLIP}: A Vision Foundation Model for the Tree of Life},
author = {Samuel Stevens and Jiaman Wu and Matthew J Thompson and Elizabeth G Campolongo and Chan Hee Song and David Edward Carlyn and Li Dong and Wasila M Dahdul and Charles Stewart and Tanya Berger-Wolf and Wei-Lun Chao and Yu Su},
booktitle={Proceedings of the IEEE/CVF Conference on Computer Vision and Pattern Recognition (CVPR)},
year = {2024}
}
Also consider citing the BioCLIP code:
@software{bioclip2023code,
author = {Samuel Stevens and Jiaman Wu and Matthew J. Thompson and Elizabeth G. Campolongo and Chan Hee Song and David Edward Carlyn},
doi = {10.5281/zenodo.10895871},
title = {BioCLIP},
version = {v1.0.0},
year = {2024}
}
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file pybioclip-2.1.6.tar.gz.
File metadata
- Download URL: pybioclip-2.1.6.tar.gz
- Upload date:
- Size: 2.8 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
eb7a74a0e8b47dd729cf0f848ae3e65bdda75872c62f4286a75ce9b28ba3f607
|
|
| MD5 |
3aecd7e80c4d92a959e76c3b0c4fe963
|
|
| BLAKE2b-256 |
98f667c510339bd42e6329d5d5906f7748d0bea8bc89b5c0943e0810f0cba936
|
Provenance
The following attestation bundles were made for pybioclip-2.1.6.tar.gz:
Publisher:
publish-to-pypi.yml on Imageomics/pybioclip
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pybioclip-2.1.6.tar.gz -
Subject digest:
eb7a74a0e8b47dd729cf0f848ae3e65bdda75872c62f4286a75ce9b28ba3f607 - Sigstore transparency entry: 2471830918
- Sigstore integration time:
-
Permalink:
Imageomics/pybioclip@256e467401a57c5e2cd8acb1467fbd834d757e9d -
Branch / Tag:
refs/tags/2.1.6 - Owner: https://github.com/Imageomics
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-to-pypi.yml@256e467401a57c5e2cd8acb1467fbd834d757e9d -
Trigger Event:
release
-
Statement type:
File details
Details for the file pybioclip-2.1.6-py3-none-any.whl.
File metadata
- Download URL: pybioclip-2.1.6-py3-none-any.whl
- Upload date:
- Size: 18.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b89139a1ec0466f39c8ec92a14039843e296679de82bd18a512355b740609c09
|
|
| MD5 |
d87b0a4a996b4561b2cb4423e2a326e8
|
|
| BLAKE2b-256 |
eefcdc92fae941c7eec925c94af5bb683c000c41a5fe069ced2ad4944707f457
|
Provenance
The following attestation bundles were made for pybioclip-2.1.6-py3-none-any.whl:
Publisher:
publish-to-pypi.yml on Imageomics/pybioclip
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pybioclip-2.1.6-py3-none-any.whl -
Subject digest:
b89139a1ec0466f39c8ec92a14039843e296679de82bd18a512355b740609c09 - Sigstore transparency entry: 2471831062
- Sigstore integration time:
-
Permalink:
Imageomics/pybioclip@256e467401a57c5e2cd8acb1467fbd834d757e9d -
Branch / Tag:
refs/tags/2.1.6 - Owner: https://github.com/Imageomics
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-to-pypi.yml@256e467401a57c5e2cd8acb1467fbd834d757e9d -
Trigger Event:
release
-
Statement type:
