A curated list of awesome CircuitPython guides, videos, libraries, frameworks, software and resources.

CircuitPython is Adafruit's branch of MicroPython designed to simplify experimentation and education on low-cost microcontrollers. It makes it easier than ever to start prototyping by requiring no upfront desktop software downloads. With CircuitPython you can write clean and simple Python code to control hardware instead of having to use complex low-level languages like C or C++ (what Arduino uses for programming). It's great for beginners!

Contents

• CircuitPython.org
• Guides
• Community
• Books
• Code
• Frameworks
• Hardware
• Newsletter
• In the news
• Art, logos, graphics
• Social media
• Podcasts
• Events
• Swag
• Talks
• Contributing

CircuitPython.org

CircuitPython.org is the first stop on the information snake highway. Here you can see all the supported boards and download the specific firmware for each one, including beta, latest, and previous versions. Downloads can be sorted by: maker, features, name, and more. At this time there are over 80 boards supported in the CircuitPython family!

Guides

• Welcome to CircuitPython! - An overview of CircuitPython and the community.
• CircuitPython Essentials - Learning the essential functions of CircuitPython.
• learn.adafruit.com CircuitPython - Adafruit Learning Guides on CircuitPython.
• learn.adafruit.com CircuitPython & MicroPython - Guides on both CircuitPython and MicroPython.

Community

• Adafruit CircuitPython Discord channel #CircuitPython - 24/7 chat and support on CircuitPython including a weekly podcast.
• CircuitPython Weekly Meeting - Video archive of weekly community meeting via Discord, starting from September, 2017.
• Adafruit CircuitPython Forums - The Adafruit discussion forum on CircuitPython.
• Reddit r/circuitpython - a subreddit devoted to CircuitPython.
• MicroPython Slack - a Slack channel for MicroPython users. You can get an invitation here.
• MicroPython Meetup - online and in Melbourne, Australia once a month, and Blog.

Books

• Getting started with Circuit Playground Express by Anne Barela (or purchase as part of your order from the Adafruit store) - Introduction and discussion of the Circuit Playground Express including programming via CircuitPython, MakeCode and Arduino.
• CircuitPython Development Workshop by Agus Kurniawan - This book helps you to get started with CircuitPython development. This book uses the Adafruit ItsyBitsy M0 Express board for development.
• CircuitPython for beginners with Adafruit Circuit Playground Express & Mu - Japanese by author Aoyama_PROD coming in September, 2019 from TechBookFest.
• Programming with MicroPython - by Nicholas H. Tollervey, includes CircuitPython - Discusses the MicroPython language.
• Wearable Tech Projects by Sophy Wong - Contains many wearable projects using CircuitPython.
• CircuitPython for beginners with Adafruit Circuit Playground Express & Mu - Japanese.
• Learning IoT with Python and Raspberry Pi by E.I. Horvath, E.A. Horvath
• Make Music with the Circuit Playground Express by Rick Leander - Twelve projects that make music, sound and noise with Circuit Python.
• Ten Games for the Circuit Playground Express by Rick Leander - Ten classic games adapted for Circuit Python.
• Initiation au langage CircuitPython et à la puce nRF52840 - A French introduction to CircuitPython and the nRF52840.

Code

• CircuitPython Board Software Versions: Select per board at CircuitPython.org. The source for each is also on GitHub.
• CircuitPython API Reference - A list of functions and documentation available for CircuitPython.
• CircuitPython Essentials - Learning the essential functions of CircuitPython.
• Circuit Playground Express CircuitPython API Reference - The functions and documentation specific to the Circuit Playground Express using CircuitPython.
• CircuitPython GitHub Repository - The source code for CircuitPython on GitHub.
• Adafruit CircuitPython Libraries - Current Adafruit CircuitPython Libraries. There are over 150+ libraries available. More on Libraries on CircuitPython.org.
• CircuitPython Community Libraries - CircuitPython Community Libraries. There are over 45+ libraries available.
• Adafruit Blinka - SBC Compatibility - CircuitPython Libraries on Raspberry Pi and other compatible single-board computers (SBC) running Linux.
• Awesome List for the RP2040 Macropad - A list of awesome Macropad applications, macros, 3D printed plans, and more.
• Tod Kurt's CircuitPython Tips and Tricks - A collection of tips and tricks for CircuitPython. Also available as an Adafruit Learn Guide.

Frameworks

• Glider: An app for editing Python on mobile devices wirelessly - Also a video, in development.
• The Mu Editor, IDE, REPL, and plotter for CircuitPython - The recommended Python editor for CircuitPython.
• For developers, Mu: A Python Code Editor - The documentation for Mu.
• Using Microsoft VSCode for CircuitPython - Blog post discussing the process.
• A helper for CircuitPython development with Atom - A helper for the Atom editor.
• Thonny, a Python IDE for beginners - An editor with support for CircuitPython and MicroPython.
• Microsoft Device Simulator Express - Virtual Circuit Playground Express and CircuitPython programming in Visual Studio Code.
• Slappy.io, a browser-based IDE and REPL for CircuitPython - An in-browser editor designed especially for Chromebooks. Works on almost any computer that can run a Chromium-based browser.
• CircuitPython extension for VS Code - A full featured extension for VS Code that downloads the latest CircuitPython bundle automatically, includes access to the serial console, and auto complete.
• PewPew workshops - Materials, examples, libraries and hardware for running Python game programming and electronics workshops with a minimum of problems.
• CircuitPython Online IDE - A browser based IDE for CircuitPython by River Wang

Hardware

All supported boards may be viewed at circuitpython.org to include descriptions, pictures, and compatible CircuitPython builds. For Single-Board Computers, the list of boards is under the Blinka category.

Looking to add a new board to CircuitPython? It's highly encouraged! Adafruit has four tutorials to help you do so:

• How to Add a New Board to CircuitPython
• How to add a New Board to the circuitpython.org website
• Adding a Single Board Computer to PlatformDetect for Blinka
• Adding a Single Board Computer to Blinka

CircuitPython sensors and accessories - Complete listing of sensors, LCDs, displays, robotics, breakout boards, and more.

python.digikey.com - Digi-Key electronics has a listing of all Python-supported boards on their site in one location including CircuitPython and MicroPython boards.

Newsletter

• Adafruit Daily, Python for microcontrollers - A weekly newsletter on MicroPython and CircuitPython, a spam-free list.
• Contribute to newsletter - Guidelines on contributing to the newsletter.
• Archives of all newsletters - List of every newsletter published from the start, November 2016.
• Python on Hardware weekly Videocast - Ladyada and PT review the highlights of the newsletter every week in this video series. The broadcast is also on iTunes, YouTube, IGTV (Instagram TV), and XML.

News

• CircuitPython on the Adafruit.com/blog - Adafruit Blog posts discussing CircuitPython.

• CircuitPython Show Episode 1: Kattni Rembor - Host Paul Cutler interviews CircuitPython team member Kattni Rembor, March 1, 2022.

• Scott Shawcroft Works On Bare-Metal Raspberry Pi CircuitPython as Adafruit Plans an E Ink Computer - Hackster.io, December 2021.

• The Real Python Podcast Episode 75: Building With CircuitPython & Constraints of Python for Microcontrollers - Scott Shawcroft, August 27, 2021.

• embedded.fm Podcast Episode 372: The Motivation of Creativity - interview with Anne Barela, CircuitPython team member and Python on Microcontrollers Editor, May 6, 2021.

• DroneBot Workshop: Raspberry Pi Pico with CircuitPython - March 5, 2021.

• Changing Lives through Open Source, Passion and Mentoring - the keynote talk at PyOhio, July 27, 2019 by Kattni Rembor.

• Control servos with CircuitPython and Raspberry Pi - The MagPi Magazine, Issue 84, Melissa LeBlanc-Williams, July, 2019.

• PyDev of the Week: Scott Shawcroft - July 1, 2019.

• Scott Shawcroft: History of CircuitPython - A discussion of CircuitPython for the core developers of Python, PyCon 2019.

• Five Things You Didn't Know Python Could Do - YouTube video, June 19, 2019.

• PyCon2019 Keynote - Light Up Your Life - With Python and LEDs - By Nina Zakharenko. Python opens a whole new world of working with wearable electronics. The slides are also available.

• Learn Hardware Programming with CircuitPython - A course offered by Codecademy in collaboration with Adafruit.

• Use CircuitPython boards on the TI-83 Premium CE calculator - CircuitPython runs on Texas Instrument calculators.

• Make: Vol. 68 Boards guide - Make: Magazine names Python the #1 Tech Trend for boards in 2019!

• Scott Shawcroft Is Squeezing Python Into Microcontrollers - IEEE Spectrum Magazine article on the Python programming language for makers.

• Circuit Playground Express 4-H edition approved - The 4-H branded version was approved by the USDA, this is the first CircuitPython powered board that is also 4-H approved!

• CircuitPython in Space - CircuitPython provides an approachable and logical means of conducting science with hardware. Paired with low-cost hardware shown to work in space, we can enable an new generation to question and explore the unknown. With the necessary “satellite stuff” already baked in, students can spend their time trying something new rather than reinventing the wheel.

• Adafruit PyPortal: GUI meets CircuitPython in a Big Way - Disrupt It Yourself podcast on CircuitPython and the IoT device, PyPortal.

• Cool Tools - Sophy Wong Talks Circuit Playground Express including CircuitPython.

• CircuitPython for Rapid Microcontroller-Based Prototyping and Development - Digi-Key on the open source community's efforts adapting specific microcontrollers and dev boards to support serious microcontroller development using CircuitPython.

• HackSpace Magazine - Issue 17 - CircuitPython powered Adafruit Grand Central M4 Express review.

• Python on Hardware Means Choices for Makers - By Liz Clark - Apress. CircuitPython (a fork of MicroPython that is designed from the ground up to be beginner friendly.) This allows end users to use Python for their electronics hardware projects similar to how they may have used C/C++ with the Arduino IDE.

• Method's Magazine - Methods eZine: Design Trends & the Transformation of Everything features Python on hardware, page 35 - PDF.

• HackSpace Magazine - Issue 15 - CircuitPython makes the cover on HackSpace Magazine with feature article, and projects.

• Community call for what is wanted and needed in CircuitPython by year: 2018, 2019, 2021, 2022

• CircuitPython in MicroSolutions Digital Magazine - Microchip’s MicroSolutions, “Python on Microcontrollers” in Design Corner article. MicroSolutions is Microchip’s bi-monthly digital magazine.

• CircuitPython Snakes its Way onto Adafruit Hardware - An article by MAKE on CircuitPython.

• Adafruit Circuit Playground Express review - Raspberry Pi reviews the Circuit Playground Express.

• The Amp Hour #383 - An Interview with Scott Shawcroft.

• CircuitPython on Hackaday - Hackaday posts related to CircuitPython.

• CircuitPython on hackster.io - Posts on hackster.io related to CircuitPython.

• CircuitPython on MAKE - CircuitPython related content on MAKE.

Art

• CircuitPython Art Pack! Logos, banners, photos and Blinka! - Adafruit art relating to CircuitPython.

Social

• #CircuitPython tagged on Twitter, latest - Twitter posts tagged CircuitPython.
• CircuitPython Twitter - Twitter account aggregator for CircuitPython news and more.
• #CircuitPython tagged on Mastodon
• CircuitPython videos on YouTube, latest - YouTube posts tagged CircuitPython.
• #CircuitPython tagged photos & videos on Instagram - Posts on Instagram tagged CircuitPython.
• CircuitPython - micropython.org forums - Articles on the MicroPython forums tagged for CircuitPython.
• CircuitPython tagged on Reddit - Reddit posts relating to CircuitPython.
• CircuitPython community on Reddit - Dedicated home of CircuitPython on reddit r/circuitpython/.
• CircuitPython on Hackaday.io - Curated list of projects on hackaday.io.
• CircuitPython on hackster.io - Python on hardware projects on hackster.io including CircuitPython.
• CircuitPython on Instructables - How-tos, guides, and more, using CircuitPython on Autodesk's Instructables.

Podcasts

• Weekly community chat on Adafruit Discord server CircuitPython channel - Audio / Podcast edition - Audio from the Discord chat space for CircuitPython, meetings are usually Mondays at 2pm ET, this is the audio version on iTunes, Pocket Casts, Spotify, and XML feed.
• The CircuitPython Show - an interview podcast with people in the CircuitPython community hosted by Paul Cutler.
• The Best Python Podcasts - The Best Python Podcasts.

Events

• Weekly community chat on Adafruit Discord server CircuitPython channel - The Discord chat space for CircuitPython, meetings are usually Mondays at 2pm ET.
• Weekly Adafruit Show-and-tell, Wednesday 7:30pm ET on YouTube LIVE - The weekly Adafruit Show-and-tell program often has CircuitPython-related projects on display.
• ASK AN ENGINEER, Wednesday 8pm ET on YouTube LIVE - The longest running YouTube live show about electronics, information on CircuitPython each week during "Python on hardware segment".
• PyCon 2023 - Salt Lake City, Utah USA April 19 - April 27, 2023.
• John Park's CircuitPython Parsec, Thursdays 4pm ET on YouTube LIVE - John Park shares CircuitPython tips and tricks.

Swag

• CircuitPython 8 release poster - CircuitPython release version 8 poster.
• CircuitPython 7 release poster - CircuitPython release version 7 poster.
• CircuitPython 6 release poster - CircuitPython release version 6 poster.
• CircuitPython 5 release poster - CircuitPython release version 5 poster.
• CircuitPython 4 release poster - CircuitPython release version 4 poster featuring Nordic.
• CircuitPython 3 release poster - CircuitPython release version 3 poster.
• Blinka the CircuitPython Limited Edition Enamel Pin - An enamel pin with the CircuitPython mascot.
• Blinka the CircuitPython Sticker - A sticker featuring Blinka, the CircuitPython mascot.
• Blinka the CircuitPython Temporary Tattoo - A temporary tattoo featuring the Blinka character.
• CircuitPlayground lanyard - CircuitPlayground lanyard featuring Blinka.

Talks

• CircuitPython 入门 - CircuitPython 程序！An entry level CircuitPython tutorial in Chinese 01: From zero to Hello World (YouTube).
• Changing Lives through Open Source, Passion and Mentoring - Changing Lives through Open Source, Passion and Mentoring, Keynote by Kattni Rembor at PyOhio 2019.
• CircuitPython: Python on hardware - CircuitPython: Python on hardware by Dave Astels at PyCon Canada.
• Embedded Programming for everyone using MicroPython and CircuitPython - Embedded Programming for everyone using MicroPython and CircuitPython by Ayan Pahwa at FOSSASIA Summit.
• EuroPython 2019 talk video: Nicholas Tollervey – Tools of the Trade: The Making of a Code Editor - Nicholas Tollervey.
• EuroPython 2019 talk video: Radomir Dopieralski – Game Development with CircuitPython - Radomir Dopieralski.
• Extending MicroPython: Using C for good - A look at how MicroPython can be extended to add features and improve performance. By Matt Trentini at PyCon Australia.
• Hanselminutes Technology Podcast – Learning CircuitPython with Scott Shawcroft - Scott Shawcroft.
• Lighting Macro Photographs with CircuitPython - Lighting Macro Photographs with CircuitPython by Stacy Morse at PyCon Australia.
• Max Holiday - CircuitPython in space, SmallSats and more! - Max Holiday.
• MicroPython & the Internet of Things - MicroPython & the Internet of Things by Damien George at GOTO 2016.
• PyCon2019 Keynote: Python on Hardware – Nina Zakharenko - Nina Zakharenko.
• PyCon India - 2019 Interactive Hardware Poster Presentation powered by CircuitPython by Ayan Pahwa and Aakanksha Agrawal - Ayan Pahwa and Aakanksha Agrawal.
• VIDEO: PyCascades – Light Up Your Life – With Python and LEDs - Nina Zakharenko.
• Writing fast and efficient MicroPython - Writing fast and efficient MicroPython by Damien George at PyCon Australia.
• More Fun with Hardware and CircuitPython -- IoT, Wearables, and More! - Nina Zakharenko at PyCon 2021.
• EuroPython 2022 talk video: Radomir Dopieralski - Game Development with CircuitPython - Radomir Dopieralski

Contributing

Contributions and suggestions are always welcome! Please make pull requests from your own fork to modify Awesome CircuitPython.

The workflow is explained in detail here: Adafruit : Contribute to CircuitPython with Git and GitHub.

Contribution Workflow Overview

1. Fork this repository on GitHub.
2. Clone the forked repo to your drive.
3. Add a remote using owner adafruit and the original URL.
4. Fetch the remote.
5. Merge adafruit or main.
6. Create a branch.
7. Make a change.
8. Commit and push to your repo.
9. Create a pull request on the official repo.
10. Once accepted, repeat by merging from the official repo to your fork's master, and re-branch.

Questions? We're happy to help you to contribute on Discord.

License & Trademarks

To the extent possible under law, the authors have waived all copyright and related or neighbouring rights to this work.

Last updated: November 2, 2022