Qamomile v0.11.0

Qamomile v0.11.0 is a follow-up to the v0.10.0 rebuild, focused on hardening the compiler core for parametric QAOA-style workloads, adding a reusable entangling-layer primitive, and cleaning up the internal compiler hierarchy introduced in v0.10.0.

pip install qamomile==0.11.0

Highlights¶

• Parametric Vector QAOA now compiles correctly end-to-end. A bundle of fixes lets parametric Vector[Float] parameters survive shape resolution, nested value resolution, and pauli_evolve, eliminating a class of silent miscompilations in QAOA-style patterns (#333):

  • pauli_evolve now accepts a parametric gamma.

  • A new compile-time shape resolution and validation pass catches shape mismatches before emit.

  • Vector parameter shape construction is unified around symbolic dimensions.

  • ValueResolver no longer silently falls back to 0 for unresolved values, and nested resolution gaps are closed.

• New building block: cx_entangling_layer — a reusable CX entangling layer for variational circuits, so you no longer have to hand-wire the CX pattern (#328).

• Compiler core refactor. ControlledUOperation now forms a small typed hierarchy, ExecutableProgram is cleanly separated from the program plan, and several dead paths are removed: Block._dependency_graph, the emit_decomposition helper (decompositions are now a data-only SSOT), and estimator/DESIGN.md. Frontend source comments are now fully English (#330).

Bug Fixes¶

• Fix silent miscompilation of parametric Vector QAOA patterns (#333).

• Remove silent 0 fallback in ValueResolver; close nested-resolution gaps (#333).

• Fix CUDA-Q emit_ch / emit_cy double-recording in the tracing test emitter (#330).

Documentation¶

• New Binary Model tutorial in both English and Japanese (#326).

• Notebooks across the docs re-executed against the current API; broken links removed; Google Colab install command added (#323).

• README refreshed (#323).

Developer Experience / Tooling¶

• Ruff is now the single source of lint + format for qamomile/ and tests/, including isort rules (combine-as-imports). CI lints tests as well (#321).

• build.sh / Makefile generalized from a single TARGET_DIR to TARGET_DIRS, so docs/en and docs/ja build from one command (#323).

Learn More¶

• Tutorials

• GitHub Repository