Skip to main content

HKD Solver

A specialized exact optimization accelerator that measured 4.332× Gurobi throughput on its published set-cover benchmark, with 500/500 exact solutions verified.

Exact minimum-cost set-cover optimization with a measured 4.3x+ throughput result on the included benchmark workload.

HKD Solver is a specialized exact optimizer for minimum-cost set cover. The FREE edition supports models up to 2,000 decision variables and 2,000 linear coverage constraints. The PAID edition removes that artificial HKD model-size ceiling.

Measured Benchmark

On the tested Mac/Python environment, test.py ran 500 independently verified exact optimization jobs using both HKD Solver FREE and Gurobi.

The measured aggregate throughput advantage was:

4.332x

HKD Solver completed approximately 23,054 jobs/second, compared with approximately 5,322 jobs/second for Gurobi on this specific benchmark workload.

Verbatim stdout

HKD_SOLVER_FREE_GUROBI_BENCHMARK_V5
free_max_variables=2000
free_max_linear_constraints=2000
paid_available=False
gurobi_available=True

FREE
objective=3
expected_objective=3
exact=True

Restricted license - for non-production use only - expires 2026-11-23
GUROBI
available=True
jobs=500
total_seconds=0.093944006
median_job_seconds=0.000185500
jobs_per_second=5322.319

HKD_SOLVER_FREE
jobs=500
total_seconds=0.021688473
median_job_seconds=0.000042958
jobs_per_second=23053.721

RESULT
jobs_verified=500
all_exact=True
aggregate_throughput_speedup_x=4.332
required_speedup_x=4.000
VERIFIED_4X=True
PASS=True

The Restricted license... line above is emitted by the installed Gurobi package itself; it is retained here because this section is verbatim stdout from the run.

What the result means

For this benchmark:

  • Gurobi: 5,322.319 jobs/second
  • HKD Solver FREE: 23,053.721 jobs/second
  • Aggregate throughput speedup: 4.332x
  • Exact jobs verified: 500 / 500
  • Required benchmark threshold: 4.000x
  • Result: PASS

The comparison is deliberately based on exact solutions. A faster answer is not useful if it changes the optimum. Every benchmark job required the HKD objective to match the independently checked exact objective.

FREE Edition

HKD Solver FREE is intended for evaluation and smaller optimization models.

For the linear set-cover formulation, its model-size limits are:

maximum decision variables = 2000
maximum linear constraints = 2000

The FREE solver uses the same exact optimization semantics and verifies its returned solution.

PAID Edition

HKD Solver PAID removes the artificial FREE model-size ceiling and is intended for larger optimization workloads.

The accompanying large aviation test uses:

problem=AVIATION_CREW_DUTY_COVER
flight_leg_constraints=2001
candidate_duty_variables=2101
expected_objective=667

The FREE edition rejects that model because it exceeds its configured limits, while the PAID edition can run larger models.

Buy HKD Solver PAID

Purchase link:

https://buy.stripe.com/4gMcMYg9daEn23g6ALgUM0c

Reproduce the benchmark

With gurobipy available, run:

python test.py

The benchmark does not hard-code a successful speedup. It measures both implementations on the current machine and reports:

aggregate_throughput_speedup_x=...
required_speedup_x=4.000
VERIFIED_4X=...
PASS=...

PASS=True for the performance comparison requires a freshly measured aggregate throughput speedup of at least 4.000x.

If Gurobi is unavailable for the installed Python version, the portable test can still verify HKD correctness and explicitly reports that the Gurobi comparison was skipped.

Scope of the benchmark

The 4.332x result is a measured result for the included high-throughput minimum-cost set-cover benchmark. It should not be interpreted as a claim that HKD Solver is 4.332x faster on every mathematical optimization model or every Gurobi workload.

Performance depends on model structure, problem size, hardware, Python version, solver configuration, and workload.

Exactness

HKD Solver is designed around exact optimization rather than approximate objective quality.

The benchmark requires:

jobs_verified=500
all_exact=True

before a speedup result is accepted.

Theory of Operation

HKD Solver is based on a simple observation about many large discrete optimization problems:

the logical size of a problem and the amount of state that must actually change during a useful search step are often very different.

Traditional solver implementations may repeatedly perform work associated with a comparatively large model even when a particular transition affects only a small part of the active search state.

HKD Solver is designed around active-state proportional computation.

Conceptually, instead of treating every search transition as requiring work proportional to the complete logical problem, HKD maintains sufficient exact state to concentrate computation on the portion of the problem that is currently relevant.

For a logical problem state (S), let:

  • (N) denote the size of the complete logical state;
  • (A(S)) denote the active portion relevant to the current transition;
  • (|A(S)|) denote the amount of active work.

A conventional implementation may contain operations whose practical cost behaves approximately like:

[ T_{\mathrm{general}}(S) \propto N ]

HKD attempts to move appropriate operations toward:

[ T_{\mathrm{HKD}}(S) \propto |A(S)| ]

When:

[ |A(S)| \ll N ]

the difference can become substantial.

Exactness is preserved

This is not an approximation technique.

HKD does not obtain its benchmark advantage by accepting a worse objective, terminating at a nonzero optimization gap, or replacing the original optimization problem with a heuristic answer.

The solver maintains the information required to preserve exact search semantics. Candidate solutions are independently verifiable against the original constraints and objective.

The included benchmark therefore requires:

jobs_verified=500
all_exact=True

## Benchmark publication note

Before publicly publishing third-party solver benchmark results, verify
that publication is permitted by the license under which that solver was
run. License terms can differ between size-limited, evaluation,
academic, and commercial installations.

## HKD Solver Cloud

Submit an optimization problem to the HKD Solver Cloud and receive a verified HKD result.

### HKD Quick Solve — $19
Small optimization jobs.

**Buy:** https://buy.stripe.com/eVqeV64qv6o78rE8ITgUM0e

### HKD Professional Solve — $79
Larger optimization jobs with verification and solver statistics.

**Buy:** https://buy.stripe.com/9B600c2in4fZfU62kvgUM0f

### HKD Heavy Solve — $299
High-capacity optimization jobs for larger workloads.

**Buy:** https://buy.stripe.com/cNi3co5uzdQz23g8ITgUM0g

### HKD Optimization Report — $999
Optimization result plus detailed solution and computational report.

**Buy:** https://buy.stripe.com/6oU3co8GLbIreQ29MXgUM0h

### Measured HKD Benchmark

A reproducible benchmark measured:

- Reference exact solver: 2354.060625 ms
- HKD: 0.138542 ms
- Speedup: 16,991.67x
- Objective match: True
- Exact verification: True

This is a measured result for the published benchmark instance, not a claim of the same speedup on every optimization problem.

HKD Solver Cloud is live.

A reproducible exact optimization benchmark measured:

Reference exact solver: 2354.060625 ms
HKD:                    0.138542 ms
Measured speedup:        16,991.67x
Objective match:         TRUE
Exact verification:      TRUE

This is a benchmark-specific result, not a claim that every optimization problem sees the same speedup.

Commercial solving:

Quick Solve — $19
https://buy.stripe.com/eVqeV64qv6o78rE8ITgUM0e

Professional Solve — $79
https://buy.stripe.com/9B600c2in4fZfU62kvgUM0f

Heavy Solve — $299
https://buy.stripe.com/cNi3co5uzdQz23g8ITgUM0g

Optimization Report — $999
https://buy.stripe.com/6oU3co8GLbIreQ29MXgUM0h

Send a set-cover / exact-cover optimization problem and receive a verified HKD result.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hkd_solver-1.0.1.tar.gz (12.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

hkd_solver-1.0.1-py3-none-any.whl (12.3 kB view details)

Uploaded Python 3

File details

Details for the file hkd_solver-1.0.1.tar.gz.

File metadata

  • Download URL: hkd_solver-1.0.1.tar.gz
  • Upload date:
  • Size: 12.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for hkd_solver-1.0.1.tar.gz
Algorithm Hash digest
SHA256 2749cd60bfb936ef87f03bcfa369fefccfd55ccb566f88250694a64ce260f19e
MD5 84e60e31acd0bd33301353a98732a71d
BLAKE2b-256 0bb9e25254719bec15252d93aafbba4438e55483aba49befb328e25fc21993a8

See more details on using hashes here.

Provenance

The following attestation bundles were made for hkd_solver-1.0.1.tar.gz:

Publisher: release.yml on yangofzeal/hkd_solver

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file hkd_solver-1.0.1-py3-none-any.whl.

File metadata

  • Download URL: hkd_solver-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 12.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for hkd_solver-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 204fe4c5c9eb059c556b1394fd4da551fcfee99fcb623b6e544f199db440a49d
MD5 a94b4941eaa80e75ad9861b1f5ce9fd8
BLAKE2b-256 ae4599a6b177a75fb847c041126faf853b93a4d3b004a4ff789359e9c31b35fc

See more details on using hashes here.

Provenance

The following attestation bundles were made for hkd_solver-1.0.1-py3-none-any.whl:

Publisher: release.yml on yangofzeal/hkd_solver

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

1.0.1 This release

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page