Update README.md

README.md

@@ -35,6 +35,22 @@ base_model:
 
 This model demonstrates a proof-of-concept for hybrid quantum-classical machine learning applied to sentiment analysis.
 
+### Quantum Component & Execution Modes
+
+Chronos 1.5B supports multiple quantum kernel execution modes:
+
+| Mode                          | Description                                                                                             | Availability                                   |
+|-------------------------------|---------------------------------------------------------------------------------------------------------|------------------------------------------------|
+| **Classical simulation**      | Fully classical implementation of the quantum kernel (default in `inference.py`)                       | Works out-of-the-box                           |
+| **Local quantum circuit**     | Real 125-qubit parametric quantum circuit stored in the repository (`quantum_kernel_circuit.json` + trained gate angles); can be executed via Qiskit Runtime on local backends or simulators | Requires manual activation  |
+| **Cloud execution on IBM Quantum** | Quantum kernel was compiled and executed on the **Heron r2** processor (**backend: ibm_fez**) in 2025 using Qiskit Runtime Sampler (resilience_level=1, optimization_level=3) | Available with an IBM Quantum account |
+
+**Key technical details**:
+- The main 1.5B-parameter model is a **merged** version of VibeThinker-1.5B with a LoRA adapter that contains **trained quantum parameters** (rotation angles of the quantum feature map).
+- These quantum angles were obtained from real executions on the Heron r2 processor (ibm_fez).
+- When loading the model with standard `AutoModel.from_pretrained()`, you get the already-merged weights — the quantum-trained parameters are baked in and work in pure classical mode without requiring quantum hardware.
+- Optionally, users can load the separate quantum circuit from the repository and run the kernel on real IBM Quantum hardware or simulators.
+
 ## Architecture
 
 ![chrn](https://cdn-uploads.huggingface.co/production/uploads/67329d3f69fded92d56ab41a/DPIBm4hDJd9ztLz2EE0jU.png)