Metadata-Version: 2.4
Name: ascent-science-cim
Version: 0.1.0
Summary: Remote Boson Quantum CIM optimizer for the Ascent Science SDK
Author: Ascent Science
License-Expression: LicenseRef-Proprietary
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Typing :: Typed
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: ascent-science<0.10,>=0.9.5

# Ascent Science CIM plugin

This package exposes the platform-hosted Boson Quantum coherent Ising machine
through `ascent.quantum.CIMOptimizer`. The client package does not install the
Kaiwu SDK or contain Boson Quantum credentials; those remain on the platform
worker.

```bash
python -m pip install -e ./sdk-python -e ./sdk-plugins/cim
```

```python
import ascent

solver = ascent.quantum.CIMOptimizer(
    precision=8,
    interval=1,
    execution_timeout=3600,
)
result = solver.solve_qubo([
    [-2.0, 1.0],
    [1.0, -1.0],
])

print(result.best_solution)
print(result.best_spins)
print(result.best_value)
```

The solver accepts QUBO matrices containing 2 to 32 variables. Calls are
submitted as durable platform jobs and polled until completion. Set an
`idempotency_key` on `solve_qubo` when retrying the same logical request.

## Build a release

```bash
sh scripts/build-release.sh
```
