Metadata-Version: 2.4
Name: lightrider
Version: 0.1.1
Summary: Quantum random numbers from IQM hardware-generated bit pools
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: numpy>=1.21

# lightrider

Quantum random numbers sourced from IQM hardware measurements.

## Installation

```bash
pip install lightrider
```

## Usage

```python
from lightrider import IQM_sirius

# 5 random integers between 1 and 100
IQM_sirius(5, 1, 100)
# → [42, 7, 88, 13, 56]

# 3 floats between 0.0 and 1.0 in steps of 0.1
IQM_sirius(3, 0.0, 1.0, step=0.1)
# → [0.3, 0.8, 0.1]

# 4 floats between 10.0 and 99.9 in steps of 0.1
IQM_sirius(4, 10.0, 99.9, step=0.1)
# → [23.4, 67.8, 45.1, 88.0]
```

## API

### `IQM_sirius(count, min_val, max_val, step=None)`

| Parameter | Type | Description |
|-----------|------|-------------|
| `count` | `int` | Number of values to return |
| `min_val` | `int` or `float` | Inclusive lower bound |
| `max_val` | `int` or `float` | Inclusive upper bound |
| `step` | `float` or `None` | Value granularity; `None` means integer steps |

Returns a `list` of quantum-random numbers in `[min_val, max_val]`.

## Data source

The pool contains ~2 million bits collected from IQM quantum hardware via Hadamard coin-flip circuits across 10 qubits. Numbers are produced using rejection sampling for unbiased output.
