Quantagonia API Client
This package contains Quantagonia's CLI client and client-side APIs for using HybridSolver in the cloud.
Installation
Python >= 3.8 is required. Then, do
python -m pip install quantagonia-api-client
In order to use HybridSolver through Quantagonia's cloud system, you'll need to sign up for an API key and set it system-wide by
export QUANTAGONIA_API_KEY=<your API key here>
Quick start: using the CLI client
This package provides the script hybridsolver to interact with the
cloud solver. In order to solve a MIP (supported formats: .mps, .lp, .mps.gz, .lp.gz) or QUBO (spported formats: .qubo, .qubo.gz), just
use
hybridsolver solve path/to/example.mps
which will automatically set all parameters and solver controls to their default value, which is a good compromise for many middle-sized optimization problems out there.
The solve call has a few options (try hybridsolver solve --help) and will, after submitting the problem, stream the logs and output the
solution vector if one is found.
To start a job without attaching to its log stream and leave it running in the background, use
hybridsolver submit path/to/example.mps
which supports the same parameters as solve and returns a job_id.
using this ID, logs, results and job status as well as time billed can
be retrieved using
hybridsolver (logs | solution | status | time_billed) job_id
Lastly, in order to cancel a runnning job and avoid unnecessary
costs, use hybridsolver cancel job_id. To list k active and/or past jobs,
use hybridsolver list --n=k.
Using the API client in your own code
The capabilities of the API client include, but are not limited to:
- a plugin for PuLP to solve PuLP-generated models locally and in the client,
- a simple API to model QUBOs locally and solve them in the cloud and
- an importer to convert PyQUBO models into our format - allowing to solve PyQUBO models in QUantagonia's cloud.
For starters, you can run the examples in examples/ through, e.g.,
QUANTAGONIA_API_KEY="<redacted>" python examples/submit_qubo.py
with a valid Quantagonia API key.
For more details, we refer to our API reference.
1 maintainer
Release files for quantagonia-api-client 0.85
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| quantagonia_api_client-0.85-py3-none-any.whl | Python 3 | none | any | Details |
Release files / quantagonia_api_client-0.85-py3-none-any.whl
| Download URL | quantagonia_api_client-0.85-py3-none-any.whl |
|---|---|
| Size | 75.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d31992a36f9681d17bb00693b35396c6d1b11d2584e854a7217966cefec33777
|
|
BLAKE2b-256 checksum How to use checksums |
b551f1aeb1cbf5d089ebe7d1094fe014e63bdb3e32b27dcd82f27637d390c749
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.10.12
|
