Metadata-Version: 2.4
Name: quantumrand-sdk
Version: 1.0.0
Summary: True quantum randomness from Origin Wukong — one line of code.
Home-page: https://quantumrand.dev
Author: QuantumRand
Author-email: jbearswrld@proton.me
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Security :: Cryptography
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.28.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# quantumrand-sdk

True quantum randomness from Origin Wukong — one line of code.

## Installation

```bash
pip install quantumrand-sdk
```

## Quick Start

```python
from quantumrand import QuantumRandClient

client = QuantumRandClient(api_key="qr_your_key_here")

# Generate random bits
bits = client.random_bits(128)

# Generate a random integer
result = client.random_int(1, 100)

# Generate random bytes
result = client.random_bytes(32)

# Check usage
usage = client.usage()
```

## API Reference

### `QuantumRandClient(api_key, base_url="https://api.quantumrand.dev")`

- `random_bits(num_bits=128)` — Generate quantum random bits
- `random_int(min_val=0, max_val=255)` — Generate a random integer in range
- `random_bytes(num_bytes=16)` — Generate random bytes (hex-encoded)
- `usage()` — Get API usage statistics

## License

MIT
