{"id":15142245,"url":"https://github.com/adafruit/circuitpython_community_bundle","last_synced_at":"2026-04-02T19:42:24.943Z","repository":{"id":23182128,"uuid":"98363921","full_name":"adafruit/CircuitPython_Community_Bundle","owner":"adafruit","description":"A bundle of useful CircuitPython libraries from the CircuitPython community.","archived":false,"fork":false,"pushed_at":"2025-05-09T05:12:07.000Z","size":739,"stargazers_count":184,"open_issues_count":3,"forks_count":86,"subscribers_count":31,"default_branch":"main","last_synced_at":"2025-05-15T20:56:27.486Z","etag":null,"topics":["circuitpython"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/adafruit.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2017-07-26T01:10:28.000Z","updated_at":"2025-05-09T05:12:10.000Z","dependencies_parsed_at":"2023-12-07T06:23:48.108Z","dependency_job_id":"27643c93-a33e-4dd2-a13c-5ded5c95ac6a","html_url":"https://github.com/adafruit/CircuitPython_Community_Bundle","commit_stats":{"total_commits":504,"total_committers":80,"mean_commits":6.3,"dds":0.5476190476190477,"last_synced_commit":"fee3bfbad7bb4ce33dd7d24a60f0096af66d94fc"},"previous_names":[],"tags_count":374,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adafruit%2FCircuitPython_Community_Bundle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adafruit%2FCircuitPython_Community_Bundle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adafruit%2FCircuitPython_Community_Bundle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adafruit%2FCircuitPython_Community_Bundle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adafruit","download_url":"https://codeload.github.com/adafruit/CircuitPython_Community_Bundle/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254518384,"owners_count":22084374,"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":["circuitpython"],"created_at":"2024-09-26T09:24:55.768Z","updated_at":"2026-01-04T07:17:56.092Z","avatar_url":"https://github.com/adafruit.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CircuitPython Community Library Bundle\n\n[![Doc Status](https://readthedocs.org/projects/circuitpython/badge/?version=latest)](https://circuitpython.readthedocs.io/en/latest/docs/drivers.html) [![Discord](https://img.shields.io/discord/327254708534116352.svg)](https://adafru.it/discord)\n\n![Blinka Community](https://github.com/adafruit/CircuitPython_Community_Bundle/blob/main/adafruit_circuitpython_community_bundle_100_large.png)\n\nThis repo bundles a bunch of useful CircuitPython libraries into an easy to\ndownload zip file. CircuitPython boards can ship with the contents of the zip to\nmake it easy to provide a lot of libraries by default.\n\n# License\nEach included library has its own license that must allow for redistribution. To\nsave space, license text is not included in the bundle. However, a link to each\nindividual repository is which should provide source code access and license\ninformation.\n\n# Use\nTo use the bundle download the zip (not source zip) from the\n[latest release](https://github.com/adafruit/CircuitPython_Community_Bundle/releases/latest),\nunzip it and copy over the subfolders, such as `lib`, into the root of your\nCircuitPython device. Make sure to indicate that it should be merged with the\nexisting folder when it exists.\n\n# Development\n\nAfter you clone this repository you must run `git submodule init` on update\nalso do `git submodule update`.\n\n## Updating libraries\nTo update the libraries run `update-submodules.sh`. The script will fetch the\nlatest code and update to the newest tag (not master).\n\n## Expectations for Library Inclusion\nYou're interested in having your library included in the Community Bundle? Great! Here are some things to keep in mind:\n\n * The subject and content of your library has to be compatible with the [Adafruit Community Code of Conduct](CODE_OF_CONDUCT.md)\n * Tagged release of the library must be compatible with [circuitpython-build-tools](https://github.com/adafruit/circuitpython-build-tools). The best way to ensure this is to use Github Actions with files like those produced by our [Cookie Cutter](https://github.com/adafruit/cookiecutter-adafruit-circuitpython/)\n * If your library has a problematic release that impacts Community Bundle releases, you will do your best to resolve it in a timely manner\n * If future changes to circuitpython-build-tools impact your library, you will do your best to resolve it in a timely manner (we try to keep breaking changes to a minimum, but they do happen!)\n\nIf a particular library is causing problems for distribution in the Community Bundle we may temporarily drop it or hold it at an old revision, so that we can continue making Community Bundle releases.\n\n## Adding a library\nDetermine the best location within `libraries` for the new library and then run:\n\n    git submodule add \u003cgit url\u003e libraries/\u003ctarget directory\u003e\n\nThe target directory should omit any MicroPython or CircuitPython specific\nprefixes such as `CircuitPython_` to simplify the listing.\n\nYou should make sure that the git url has the format `https://github.com/{:user}/{:repo}.git`,\nsuch as `https://github.com/tannewt/CircuitPython_Example.git`.  Other forms may interfere with\nadabot scripts (see https://github.com/adafruit/adabot/issues/145 for details).\n\nThe repository must have a tag, as the bundle release process pulls the latest tag, usually\nmatching a release of your library. The tag must follow the Semver format (such as *1.2.3*).\n\nThe [circuitpython_community_library_list.md](circuitpython_community_library_list.md) page is\nmanually updated. Please add your library to the list with the relevant links to the repository,\npypi page and documentation if available.\n\n## Removing a library\nOnly do this if you are replacing the module with an equivalent:\n\n    git submodule deinit libraries/\u003ctarget directory\u003e\n    git rm libraries/\u003ctarget directory\u003e\n\n## Building the bundle\nTo build this bundle locally you'll need to install the\n`circuitpython-build-tools \u003chttps://github.com/adafruit/circuitpython-build-tools\u003e`_ package.\n\n    python3 -m venv .env\n    source .env/bin/activate\n    pip install circuitpython-build-tools\n\nOnce installed, make sure you are in the virtual environment:\n\n    source .env/bin/activate\n\nThen run the build:\n\n    ./build.sh\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadafruit%2Fcircuitpython_community_bundle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadafruit%2Fcircuitpython_community_bundle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadafruit%2Fcircuitpython_community_bundle/lists"}