pybioclip
Python package that simplifies using the BioCLIP foundation model.
https://github.com/imageomics/pybioclip
Category: Biosphere
Sub Category: Biodiversity Data Access and Management
Keywords
bioclip biology clip command-line-interface cv image-classification knowledge-guided taxonomy
Keywords from Contributors
clip taxonomy
Last synced: about 10 hours ago
JSON representation
Repository metadata
Python package and CLI that simplifies using the BioCLIP family of foundation models.
- Host: GitHub
- URL: https://github.com/imageomics/pybioclip
- Owner: Imageomics
- License: mit
- Created: 2024-03-28T20:12:01.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2026-08-15T02:04:32.000Z (15 days ago)
- Last Synced: 2026-08-19T16:34:33.062Z (11 days ago)
- Topics: bioclip, biology, clip, command-line-interface, cv, image-classification, knowledge-guided, taxonomy
- Language: Python
- Homepage: https://imageomics.github.io/pybioclip/
- Size: 7.15 MB
- Stars: 65
- Watchers: 3
- Forks: 14
- Open Issues: 17
- Releases: 14
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Citation: CITATION.cff
- Zenodo: .zenodo.json
- Copilot: .github/copilot-instructions.md
README.md
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}
}
Citation (CITATION.cff)
cff-version: 1.2.0
title: pybioclip
message: If you use this software, please cite both the conference paper from references section and the software itself.
type: software
authors:
- given-names: John
family-names: Bradley
- given-names: Hilmar
family-names: Lapp
- family-names: Campolongo
given-names: "Elizabeth G."
identifiers:
- description: "The GitHub release URL of tag 2.1.5."
type: url
value: "https://github.com/Imageomics/pybioclip/releases/tag/2.1.5"
- description: "The GitHub URL of the commit tagged with 2.1.5."
type: url
value: "https://github.com/Imageomics/pybioclip/tree/4ba2dbb4668728a9c0618c4ff6960ce1945d6ab6" # update on release
repository-code: 'https://github.com/Imageomics/pybioclip'
url: 'https://github.com/Imageomics/pybioclip'
abstract: Python package and command line tool that simplifies using the BioCLIP foundation model.
keywords:
- clip
- biology
- CV
- imageomics
- animals
- species
- images
- taxonomy
- "rare species"
- "endangered species"
- "evolutionary biology"
- multimodal
- "knowledge-guided"
- python
- "command line"
- bioclip
- plants
- fungi
- genus
- "image classification"
license: MIT
version: 2.1.5
date-released: '2026-04-20'
doi: 10.5281/zenodo.13151194
Owner metadata
- Name: Imageomics Institute
- Login: Imageomics
- Email:
- Kind: organization
- Description:
- Website: https://imageomics.osu.edu
- Location:
- Twitter: imageomics
- Company:
- Icon url: https://avatars.githubusercontent.com/u/77468321?v=4
- Repositories: 4
- Last ynced at: 2023-03-05T05:05:36.574Z
- Profile URL: https://github.com/Imageomics
GitHub Events
Total
- Create event: 60
- Delete event: 45
- Fork event: 4
- Gollum event: 19
- Issue comment event: 200
- Issues event: 81
- Member event: 1
- Pull request event: 76
- Pull request review comment event: 90
- Pull request review event: 177
- Push event: 288
- Release event: 6
- Watch event: 22
Last Year
- Create event: 20
- Delete event: 11
- Issue comment event: 46
- Issues event: 22
- Pull request event: 19
- Pull request review comment event: 4
- Pull request review event: 13
- Push event: 56
- Release event: 3
- Watch event: 7
Committers metadata
Last synced: 3 days ago
Total Commits: 121
Total Committers: 9
Avg Commits per committer: 13.444
Development Distribution Score (DDS): 0.397
Commits in past year: 44
Committers in past year: 8
Avg Commits per committer in past year: 5.5
Development Distribution Score (DDS) in past year: 0.591
| Name | Commits | |
|---|---|---|
| John Bradley | j****8@g****m | 73 |
| Hilmar Lapp | h****p@d****t | 22 |
| copilot-swe-agent[bot] | 1****t | 14 |
| Elizabeth Campolongo | 3****9 | 4 |
| Matt Thompson | 3****j | 3 |
| Maximilian Sittinger | 8****t | 2 |
| flobo3 | f****3@g****m | 1 |
| Sreejith Menon | 1****8 | 1 |
| Mitchell Horn | 5****h | 1 |
Committer domains:
- drycafe.net: 1
Issue and Pull Request metadata
Last synced: 1 day ago
Total issues: 77
Total pull requests: 154
Average time to close issues: 27 days
Average time to close pull requests: 8 days
Total issue authors: 17
Total pull request authors: 10
Average comments per issue: 2.62
Average comments per pull request: 1.68
Merged pull request: 122
Bot issues: 0
Bot pull requests: 0
Past year issues: 23
Past year pull requests: 32
Past year average time to close issues: 7 days
Past year average time to close pull requests: 2 days
Past year issue authors: 11
Past year pull request authors: 8
Past year average comments per issue: 2.7
Past year average comments per pull request: 3.16
Past year merged pull request: 21
Past year bot issues: 0
Past year bot pull requests: 0
Top Issue Authors
- johnbradley (28)
- hlapp (16)
- thompsonmj (11)
- egrace479 (3)
- quitmeyer (3)
- maxsitt (2)
- work4cs (2)
- mitchellxh (2)
- nblumoe (2)
- Copilot (1)
- yanis-falaki (1)
- Link7808 (1)
- Dr-Nathan-Fox (1)
- NetZissou (1)
- smenon8 (1)
Top Pull Request Authors
- johnbradley (104)
- hlapp (19)
- Copilot (10)
- thompsonmj (10)
- egrace479 (4)
- yanis-falaki (2)
- smenon8 (2)
- NetZissou (1)
- maxsitt (1)
- mitchellxh (1)
Top Issue Labels
- documentation (5)
- enhancement (5)
- question (3)
- bug (3)
Top Pull Request Labels
- enhancement (1)
Package metadata
- Total packages: 1
-
Total downloads:
- pypi: 7,051 last-month
- Total dependent packages: 0
- Total dependent repositories: 0
- Total versions: 15
- Total maintainers: 2
pypi.org: pybioclip
Python package that simplifies using the BioCLIP foundation model.
- Homepage:
- Documentation: https://imageomics.github.io/pybioclip/
- Licenses: MIT
- Latest release: 2.1.6 (published 15 days ago)
- Last Synced: 2026-08-28T21:01:26.462Z (1 day ago)
- Versions: 15
- Dependent Packages: 0
- Dependent Repositories: 0
- Downloads: 7,051 Last month
-
Rankings:
- Dependent packages count: 10.612%
- Stargazers count: 20.892%
- Forks count: 21.322%
- Average: 28.146%
- Dependent repos count: 59.76%
- Maintainers (2)
Dependencies
- actions/checkout v4 composite
- actions/setup-python v5 composite
- peaceiris/actions-gh-pages v4 composite
- actions/checkout v4 composite
- docker/build-push-action v6 composite
- docker/login-action v3 composite
- docker/metadata-action v4 composite
- eWaterCycle/setup-apptainer v2 composite
- condaforge/miniforge3 24.3.0-0 build
- actions/checkout v4 composite
- actions/setup-python v5 composite
- pypa/gh-action-pypi-publish release/v1 composite
- open-clip-torch *
- pandas *
- prettytable *
- torch *
- torchvision *
- actions/cache v4 composite
- actions/checkout v4 composite
- actions/setup-python v5 composite
- actions/checkout v4 composite
- actions/setup-node v4 composite
Score: 15.465152161808652