pybioclip

Python package that simplifies using the BioCLIP foundation model.
https://github.com/imageomics/pybioclip

Category: Biosphere
Sub Category: Biodiversity Data Access and Management

Last synced: 12 minutes ago
JSON representation

Repository metadata

Python package that simplifies using the BioCLIP foundation model.

README.md

pybioclip

PyPI - Version
PyPI - Python Version


Command line tool and python package to simplify using BioCLIP, 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

Our code (this repository):

@software{Bradley_pybioclip_2025,
author = {Bradley, John and Lapp, Hilmar and Campolongo, Elizabeth G.},
doi = {10.5281/zenodo.13151194},
month = feb,
title = {{pybioclip}},
version = {1.3.2},
year = {2025}
}

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:
  - type: doi
    value: 10.5281/zenodo.13151194
  - description: "The GitHub release URL of tag 1.3.2."
    type: url
    value: "https://github.com/Imageomics/pybioclip/releases/tag/1.3.2"
  - description: "The GitHub URL of the commit tagged with 1.3.2."
    type: url
    value: "https://github.com/Imageomics/pybioclip/tree/c318c6c9f2bc75c4da6ac060927623de69331344"
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: 1.3.2
date-released: '2025-03-13'
references:
- type: conference-paper
  title: "BioCLIP: A Vision Foundation Model for the Tree of Life"
  authors:
    - family-names: Stevens
      given-names: Samuel
    - family-names: Wu
      given-names: Jiaman
    - family-names: Thompson
      given-names: "Matthew J."
    - family-names: Campolongo
      given-names: "Elizabeth G."
    - family-names: Song
      given-names: "Chan Hee"
    - family-names: Carlyn
      given-names: "David Edward"
    - family-names: Dong
      given-names: Li
    - family-names: Dahdul
      given-names: "Wasila M"
    - family-names: Stewart
      given-names: Charles
    - family-names: "Berger-Wolf"
      given-names: Tanya
    - family-names: Chao
      given-names: "Wei-Lun"
    - family-names: Su
      given-names: Yu
  version: 1.0.0
  doi: "10.5281/zenodo.10895871"
  date-released: "2024-03-29"

Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: about 18 hours ago

Total Commits: 68
Total Committers: 4
Avg Commits per committer: 17.0
Development Distribution Score (DDS): 0.103

Commits in past year: 65
Committers in past year: 4
Avg Commits per committer in past year: 16.25
Development Distribution Score (DDS) in past year: 0.108

Name Email Commits
John Bradley j****8@g****m 61
Hilmar Lapp h****p@d****t 4
Matt Thompson 3****j 2
Sreejith Menon 1****8 1

Committer domains:


Issue and Pull Request metadata

Last synced: 1 day ago

Total issues: 103
Total pull requests: 118
Average time to close issues: 25 days
Average time to close pull requests: 5 days
Total issue authors: 11
Total pull request authors: 5
Average comments per issue: 2.24
Average comments per pull request: 1.53
Merged pull request: 106
Bot issues: 0
Bot pull requests: 0

Past year issues: 93
Past year pull requests: 114
Past year average time to close issues: 16 days
Past year average time to close pull requests: 5 days
Past year issue authors: 11
Past year pull request authors: 5
Past year average comments per issue: 2.23
Past year average comments per pull request: 1.54
Past year merged pull request: 102
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/imageomics/pybioclip

Top Issue Authors

  • johnbradley (43)
  • hlapp (29)
  • thompsonmj (11)
  • work4cs (4)
  • quitmeyer (3)
  • Link7808 (3)
  • egrace479 (3)
  • nblumoe (3)
  • yanis-falaki (2)
  • smenon8 (1)
  • Jordan-Pierce (1)

Top Pull Request Authors

  • johnbradley (94)
  • hlapp (12)
  • thompsonmj (9)
  • yanis-falaki (2)
  • smenon8 (1)

Top Issue Labels

  • enhancement (14)
  • documentation (5)
  • question (3)

Top Pull Request Labels


Package metadata

pypi.org: pybioclip

Python package that simplifies using the BioCLIP foundation model.

  • Homepage:
  • Documentation: https://imageomics.github.io/pybioclip/
  • Licenses: mit
  • Latest release: 1.3.2 (published about 2 months ago)
  • Last Synced: 2025-04-29T20:30:51.861Z (1 day ago)
  • Versions: 6
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 387 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)

Score: 10.846381266204817