{"id":15142265,"url":"https://github.com/adafruit/adafruit_circuitpython_bundle","last_synced_at":"2026-04-01T21:15:18.328Z","repository":{"id":12659462,"uuid":"72229984","full_name":"adafruit/Adafruit_CircuitPython_Bundle","owner":"adafruit","description":"A bundle of useful CircuitPython libraries ready to use from the filesystem.","archived":false,"fork":false,"pushed_at":"2025-05-13T13:25:50.000Z","size":24328,"stargazers_count":935,"open_issues_count":15,"forks_count":201,"subscribers_count":57,"default_branch":"main","last_synced_at":"2025-05-13T14:50:23.852Z","etag":null,"topics":["circuitpython","hacktoberfest"],"latest_commit_sha":null,"homepage":"","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.rst","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":"2016-10-28T17:56:38.000Z","updated_at":"2025-05-13T13:25:55.000Z","dependencies_parsed_at":"2024-01-25T11:36:01.536Z","dependency_job_id":"235bedb8-0949-4f2a-8a12-262e3a1c6d6e","html_url":"https://github.com/adafruit/Adafruit_CircuitPython_Bundle","commit_stats":{"total_commits":1979,"total_committers":45,"mean_commits":"43.977777777777774","dds":"0.26376958059626077","last_synced_commit":"6feee1ae5d11088592099e960c534de058caab12"},"previous_names":[],"tags_count":1553,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adafruit%2FAdafruit_CircuitPython_Bundle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adafruit%2FAdafruit_CircuitPython_Bundle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adafruit%2FAdafruit_CircuitPython_Bundle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adafruit%2FAdafruit_CircuitPython_Bundle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adafruit","download_url":"https://codeload.github.com/adafruit/Adafruit_CircuitPython_Bundle/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254198514,"owners_count":22030965,"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","hacktoberfest"],"created_at":"2024-09-26T09:25:05.491Z","updated_at":"2025-11-14T07:02:37.539Z","avatar_url":"https://github.com/adafruit.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"Adafruit CircuitPython Library Bundle\n=======================================\n\n.. image:: https://readthedocs.org/projects/adafruit-circuitpython-bundle/badge/?version=latest\n    :target: https://docs.circuitpython.org/projects/bundle/en/latest/\n    :alt: Documentation Status\n\n.. image:: https://img.shields.io/discord/327254708534116352.svg\n    :target: https://adafru.it/discord\n    :alt: Discord\n\n.. image:: https://travis-ci.com/adafruit/Adafruit_CircuitPython_Bundle.svg?branch=main\n    :target: https://travis-ci.com/adafruit/Adafruit_CircuitPython_Bundle\n    :alt: Build Status\n\n.. image:: https://img.shields.io/badge/code%20style-black-000000.svg\n    :target: https://github.com/psf/black\n    :alt: Code Style: Black\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\nUse\n=====\nTo use the bundle download the zip (not source zip) from the\n`latest release \u003chttps://github.com/adafruit/Adafruit_CircuitPython_Bundle/releases/latest\u003e`_,\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\nCPython\n--------\n**DO NOT** use this to install libraries on a Linux computer, such as the Raspberry Pi,\nwith regular Python (aka CPython). Instead, use the python3 version of ``pip`` to install\nthe libraries you want to use. It will automatically install dependencies for you. For example:\n\n.. code::\n\n    pip3 install adafruit-circuitpython-lis3dh\n\nDevelopment\n============\n\nAfter you clone this repository you must run ``git submodule init``\nand then ``git submodule update``.\n\nFor developing individual libraries, please see LIBRARY_DEVELOPMENT.rst.\n\nUpdating libraries\n-------------------\nTo update the libraries run ``update-submodules.sh``. The script will fetch the\nlatest code and update to the newest tag (not main).\n\nTo find libraries with commits that haven't been included in a release do:\n\n.. code::\n\n    git submodule foreach \"git log --oneline HEAD...origin/main\"\n\nAdding a library\n-----------------\nDetermine the best location within ``libraries`` (``libraries/drivers/`` or\n``libraries/helpers/``)for the new library and then run:\n\n.. code::\n\n    git submodule add \u003cgit url\u003e libraries/\u003ctarget directory\u003e\n\nThe target directory should omit any CircuitPython specific prefixes such as\n``adafruit-circuitpython`` to simplify the listing.\n\nRemoving a library\n-------------------\nOnly do this if you are replacing the module with an equivalent:\n\n.. code::\n\n    git submodule deinit libraries/\u003ctarget directory\u003e\n    git rm libraries/\u003ctarget directory\u003e\n\nBuilding the bundle\n--------------------\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.. code::\n\n    python3 -m venv .venv\n    source .venv/bin/activate\n    pip install circuitpython-build-tools\n\nOnce installed, make sure you are in the virtual environment:\n\n.. code::\n\n    source .venv/bin/activate\n\nThen run the build:\n\n.. code::\n\n    circuitpython-build-bundles --filename_prefix adafruit-circuitpython-bundle --library_location libraries --library_depth 2\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadafruit%2Fadafruit_circuitpython_bundle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadafruit%2Fadafruit_circuitpython_bundle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadafruit%2Fadafruit_circuitpython_bundle/lists"}