Cannot install for CircuitPython

[twrackers]

Followed instructions in README file, get this result on one step:
$ circup install --py qwiic_oled Traceback (most recent call last): File "/home/pi/.local/bin/circup", line 3, in <module> from circup import main File "/home/pi/.local/lib/python3.9/site-packages/circup/__init__.py", line 9, in <module> from circup.shared import DATA_DIR, BAD_FILE_FORMAT, extract_metadata, _get_modules_file File "/home/pi/.local/lib/python3.9/site-packages/circup/shared.py", line 16, in <module> from circup.lazy_metadata import LazyMetadata File "/home/pi/.local/lib/python3.9/site-packages/circup/lazy_metadata.py", line 11, in <module> class LazyMetadata: File "/home/pi/.local/lib/python3.9/site-packages/circup/lazy_metadata.py", line 20, in LazyMetadata initial_data: dict[str, Any] | None = None, TypeError: unsupported operand type(s) for |: 'types.GenericAlias' and 'NoneType' pi@pi400 ~ $
CircuitPython version is 10.0.3, on an Adafruit Metro M7.

Also had monumental failure installing to use SparkFun SerLCD display under CircuitPython. I give up on SparkFun displays for CP, going to stick with ones from Adafruit.

[sfe-SparkFro]

Sorry to hear you had trouble with this!

@malcolm-sparkfun Can you please take a look into this when you get a chance?

[malcolm-sparkfun]

@sfe-SparkFro On first glance, package seems to be installing fine for me, but I have some older versions of circup on my machine and CircuitPython on my board. I'll try updating to circup to the latest and with a 10.0.3 install of CircuitPython and see if I can recreate this. It's possible that CircuitPython has changed something about their packaging scheme in a newer version.

Circup Version

(circup) C:\Users\malcolm>circup --version
Circup, A CircuitPython module updater. Version 2.2.2

CircuitPython Version

(circup) C:\Users\malcolm>mpremote
Adafruit CircuitPython 9.2.8 on 2025-05-28; SparkFun Pro Micro RP2350 with rp2350a

circup bundle-add command

(circup) C:\Users\malcolm>circup bundle-add sparkfun/Qwiic_Py
Version 2.2.2 of circup is outdated. Version 2.3.0 was released 4 days ago.
Added sparkfun/Qwiic_Py
    https://github.com/sparkfun/Qwiic_Py

circup install command

(circup) C:\Users\malcolm>circup install --py qwiic_oled
Version 2.2.2 of circup is outdated. Version 2.3.0 was released 4 days ago.
Found device sparkfun_pro_micro_rp2350 at D:\, running CircuitPython 9.2.8.
A newer version of CircuitPython (10.0.3) is available.
Get it here: https://circuitpython.org/board/sparkfun_pro_micro_rp2350
Searching for dependencies for: ['qwiic_oled']
Ready to install: ['qwiic_i2c', 'qwiic_oled']

Installed 'qwiic_i2c'.
Installed 'qwiic_oled'.

[malcolm-sparkfun]

@sfe-SparkFro I have re-tested with the latest circup version (2.3.0) and the stable version of CircuitPython that the user has described (10.0.3), everything still seems to install fine. I did this on a SparkFun Pro Micro RP2350 as I do not own an Adafruit Metro M7, but any issues with how that board interacts with circup or with the user's circup installation itself would not be a fix we could implement on our end, that would be an Adafruit/CircuitPython conversation. Note: all commands below were performed with Windows and a fresh install of the latest circup in a fresh venv. The qwiic_oled package appears to be installing fine:

Circup Version:

(circup_latest) C:\Users\malcolm>circup --version
Circup, A CircuitPython module updater. Version 2.3.0

CircuitPython version:

(circup_latest) C:\Users\malcolm>mpremote
Adafruit CircuitPython 10.0.3 on 2025-10-17; SparkFun Pro Micro RP2350 with rp2350a

circup bundle-add command:

(circup_latest) C:\Users\malcolm>circup bundle-add sparkfun/Qwiic_Py
Added sparkfun/Qwiic_Py
    https://github.com/sparkfun/Qwiic_Py
Using latest bundle for sparkfun/Qwiic_Py (2.0.1).
Using latest bundle for adafruit/Adafruit_CircuitPython_Bundle (20251105).
Using latest bundle for adafruit/CircuitPython_Community_Bundle (20251107).

circup install command:

(circup_latest) C:\Users\malcolm>circup install --py qwiic_oled
Found device sparkfun_pro_micro_rp2350 at D:\, running CircuitPython 10.0.3.
Using latest bundle for sparkfun/Qwiic_Py (2.0.1).
Using latest bundle for adafruit/Adafruit_CircuitPython_Bundle (20251105).
Using latest bundle for adafruit/CircuitPython_Community_Bundle (20251107).
Searching for dependencies for: ['qwiic_oled']
Ready to install: ['qwiic_i2c', 'icicled']

Installed 'qwiic_i2c'.
Installed 'qwiic_oled'.

[sfe-SparkFro]

@twrackers Looks like you're on a Pi 400, I assume with Raspberry Pi OS, yes? Can you please verify that your circup version is at least 2.3.0? Might also help to ensure your OS and python install are up to date:

sudo apt update
sudo apt upgrade
python -m pip install --upgrade pip
pip --version
pip install --upgrade circup
circup --version

If it still fails, do you have any other boards you can test with?