> Complete documentation index: [llms.txt](/llms.txt). Markdown versions of all pages are available by appending `.md` to page URLs.

# binhosupernova

> Legacy: the lower-level Python package for the Binho Supernova USB host adapter.

:::caution
**Legacy:** this documents the `binhosupernova` Python package, being phased out in favor of
[CosmicSDK and the new Python SDK](..). It remains
supported during the transition. New projects on Supernova or Pulsar should start
with [CosmicSDK](/software/cosmicsdk/).

:::

`binhosupernova` is described on PyPI as a "Python package for Binho Supernova USB
host adapter." It is the lower-level of Binho's two Supernova Python packages:
[SupernovaController](/software/legacy/supernovacontroller/) wraps it and pulls it in as a
dependency, alongside `transfer_controller`.

Most users should start with SupernovaController, which provides a blocking API
over the Supernova's asynchronous interface. Reach for `binhosupernova` directly
when work closer to the device is needed: for example, the manual firmware
flashing procedure in
[Updating Firmware](/guides/firmware-updates/) uses it
directly.

:::note
This is a legacy package. For Supernova and Pulsar, new development is going into
[CosmicSDK and the Python SDK](..). `binhosupernova`
remains available and supported in the meantime.

:::

## Requirements

* Python 3.8 or higher
* A Binho Supernova host adapter

## Installation

```sh
pip install binhosupernova
```

The latest release is **4.2.0** (11 June 2025), which added I3C HDR-DDR mode with
private write/read transfer methods, persistent voltage configuration across power
cycles for I2C, SPI, UART, and GPIO, and unified I2C pull-up resistor values
between the Supernova and Pulsar platforms.

[https://pypi.org/project/binhosupernova/](https://pypi.org/project/binhosupernova/)

:::caution
The package name's capitalization changed between generations. Firmware v4.x
procedures use `from binhosupernova.supernova import Supernova`, while v3.x
procedures use the older `from BinhoSupernova.Supernova import Supernova`. Pin the
version that matches the firmware: see
[Updating Firmware](/guides/firmware-updates/).

:::

## Related pages

* [SupernovaController](/software/legacy/supernovacontroller/)
* [binhopulsar](/software/legacy/binhopulsar/)