Upload folder using huggingface_hub

README.md

@@ -1,45 +1,45 @@
----
-title: Light Rider Quantum Entropy
-emoji: ⚛️
-colorFrom: red
-colorTo: yellow
-sdk: gradio
-sdk_version: 6.30.0
-app_file: app.py
-pinned: false
-license: apache-2.0
-short_description: Entropy from named quantum sources, with signed receipts
----
-
-# Light Rider Quantum Entropy
-
-Draw random bytes from **named quantum sources** (quantum random number generators
-and quantum processors). Every draw comes with a **receipt signed by the Light Rider
-Entropy Management Service (EMS)**: it records which source produced the bytes, how
-they were health-checked and when. The app verifies the receipt's Ed25519 signature
-against EMS's published key and shows the result.
-
-This is an alternative entropy source with verifiable provenance. It is not a claim
-that quantum randomness is better than a good classical generator. If a source can't
-serve, you'll see why. Nothing is ever substituted, and nothing is generated locally.
-
-## Use it from your code
-
-```python
-import lightrider as lr                       # pip install lightrider (1.6.0+), export LR_API_KEY=lr_live_...
-r = lr.entropy.get(32, source="anu_aws_001")  # or sources=["anu_aws_001", "cisco_qrng_001"]
-print(r.hex, r.request_id, r.sources)
-assert lr.entropy.verify(r.receipt)
-seed = lr.entropy.seed(64)                    # int seed for numpy / torch
-```
-
-Get your Light Rider API key from Light Rider Cloud (Settings → API Keys). It is a
-full-access account key: keep it out of public code and store it as a Space secret.
-
-## Space configuration
-
-Secrets: `LR_API_KEY` (demo account key), `LR_ENTROPY_BASE_URL`, and
-`LR_VERCEL_BYPASS` (only while pointing at a protected preview deployment).
-
-Optional variables: `DEMO_PER_VISITOR_DAILY` (default 5), `DEMO_GLOBAL_DAILY`
-(default 200), `LR_PUBLIC_SITE_URL`, `LR_CLOUD_KEYS_URL`.
+---
+title: Light Rider Quantum Entropy
+emoji: ⚛️
+colorFrom: red
+colorTo: yellow
+sdk: gradio
+sdk_version: 6.30.0
+app_file: app.py
+pinned: false
+license: apache-2.0
+short_description: Entropy from named quantum sources, with signed receipts
+---
+
+# Light Rider Quantum Entropy
+
+Draw random bytes from **named quantum sources** (quantum random number generators
+and quantum processors). Every draw comes with a **receipt signed by the Light Rider
+Entropy Management Service (EMS)**: it records which source produced the bytes, how
+they were health-checked and when. The app verifies the receipt's Ed25519 signature
+against EMS's published key and shows the result.
+
+This is an alternative entropy source with verifiable provenance. It is not a claim
+that quantum randomness is better than a good classical generator. If a source can't
+serve, you'll see why. Nothing is ever substituted, and nothing is generated locally.
+
+## Use it from your code
+
+```python
+import lightrider as lr                       # pip install lightrider (1.6.0+), export LR_API_KEY=lr_live_...
+r = lr.entropy.get(16, source="anu")          # or sources=["anu", "cisco"]
+print(r.hex, r.request_id, r.sources)
+assert lr.entropy.verify(r.receipt)
+seed = lr.entropy.seed(64)                    # int seed for numpy / torch
+```
+
+Get your Light Rider API key from Light Rider Cloud (Settings → API Keys). It is a
+full-access account key: keep it out of public code and store it as a Space secret.
+
+## Space configuration
+
+Secrets: `LR_API_KEY` (demo account key), `LR_ENTROPY_BASE_URL`, and
+`LR_VERCEL_BYPASS` (only while pointing at a protected preview deployment).
+
+Optional variables: `DEMO_PER_VISITOR_DAILY` (default 5), `DEMO_GLOBAL_DAILY`
+(default 200), `LR_PUBLIC_SITE_URL`, `LR_CLOUD_KEYS_URL`.

app.py

@@ -115,7 +115,8 @@ def visitor_id(request: gr.Request | None) -> str:
 
 def _label(s: lre.Source) -> str:
     state = f"{s.bytes_available:,} B on hand" if s.ready else "out of entropy, refill pending"
-    return f"{s.name} · {s.type} · {state}"
+    name = f"{s.name} ({s.alias})" if s.alias else s.name
+    return f"{name} · {s.type} · {state}"
 
 
 def load_sources():
@@ -251,12 +252,14 @@ export LR_API_KEY=lr_live_... # your Light Rider API key
 ```python
 import lightrider as lr
 
-r = lr.entropy.get(32, source="anu_aws_001")   # or sources=["anu_aws_001", "cisco_qrng_001"]
+r = lr.entropy.get(16, source="anu")           # or sources=["anu", "cisco"]
 print(r.hex, r.request_id, r.sources)
 assert lr.entropy.verify(r.receipt)            # Ed25519 against EMS's published key
 seed = lr.entropy.seed(64)                     # int seed for numpy / torch
 ```
 
+- **Sources** by short name: `anu`, `cisco`, `qispace`, `rigetti`, `iqm`, `iqm-qec` (or the full id);
+  `lr.entropy.sources()` lists what's ready now. Receipts always record the full id.
 - **Get your key:** [Light Rider Cloud → API Keys]({CLOUD_KEYS_URL}). It is your account's full-access key, so keep it
   out of public code and Spaces (store it as a Space secret).
 - **Docs and the HTTP API:** [{PUBLIC_SITE}/developers]({PUBLIC_SITE}/developers)

lr_entropy_api.py

@@ -10,7 +10,7 @@ Quantum entropy with signed provenance, billed to your Light Rider credits:
 
     import lightrider as lr
 
-    r = lr.entropy.get(32, source="anu_aws_001")   # LR_API_KEY in the environment
+    r = lr.entropy.get(16, source="anu")           # LR_API_KEY in the environment
     r.data, r.hex, r.request_id                     # the bytes and their receipt id
     lr.entropy.verify(r.receipt)                    # True: EMS signed exactly this
 
@@ -209,6 +209,8 @@ class Source:
     max_single_draw_bytes: int
     custom_pool_selectable: bool
     custom_pool_reason: str | None
+    #: Short name usable as ``source=`` / in ``sources=`` (e.g. ``"anu"``).
+    alias: str | None = None
     raw: dict = field(repr=False, default_factory=dict)
 
     @property
@@ -358,6 +360,7 @@ class EntropyAPI:
                 max_single_draw_bytes=int(s.get("max_single_draw_bytes", 0)),
                 custom_pool_selectable=bool((s.get("custom_pool") or {}).get("selectable", False)),
                 custom_pool_reason=(s.get("custom_pool") or {}).get("reason"),
+                alias=s.get("alias"),
                 raw=s,
             )
             for s in body.get("sources", [])
@@ -374,6 +377,12 @@ class EntropyAPI:
         """Draw ``n_bytes`` (1-4096) from one source (``source=``) or a custom
         pool of 2-8 sources (``sources=[...]``).
 
+        Name sources by alias (``"anu"``, ``"cisco"``, ...; see
+        :meth:`sources`) or full id (``"anu_aws_001"``). Names are passed to
+        the service as given and resolved there, so new sources need no SDK
+        update; an unknown name raises :class:`InvalidRequestError` listing
+        the valid ones. Receipts always carry the full id.
+
         With neither, uses ``default_source`` / ``LR_ENTROPY_SOURCE``, else the
         first source that is ready right now (the receipt says which).
         Raises :class:`SourceEmptyError` rather than ever substituting.