Skip to main content

Getting Started

Introduction​

CircuitPython is a beginner-friendly Python environment designed for microcontrollers. It is especially popular for projects built with the Adafruit ecosystem because it has a large collection of reusable libraries for displays, sensors, LEDs, and HID devices.

Why Use CircuitPython?​

CircuitPython can be a good choice when you want:

  • simple drag-and-drop code updates
  • strong library support
  • easy file-based workflows
  • quick experiments with hardware modules

Typical Workflow​

The CircuitPython workflow is different from MicroPython:

  1. install the CircuitPython firmware
  2. connect the board and open the CIRCUITPY drive
  3. copy code.py onto the board
  4. add required libraries into the lib folder

This feels more like working with files on a USB drive than using a REPL-first workflow.

What Will Go Here Later​

This page is the starting point for future CircuitPython tutorials on NerdCave, including:

  • displays
  • sensors
  • NeoPixels
  • HID keyboards and controllers
  • Adafruit library based examples