CADAQUES

Cost-Aware Dual Architecture for QUery-Efficient diScovery

An open-source framework for autonomous discovery campaigns: any oracle, any driver, one budget. Every query counts.

CADAQUES decouples autonomous discovery into two symmetric protocols. A metered Oracle abstracts anything that answers queries at a price — a simulator, a laboratory instrument, an analytic function. A Driver abstracts anything that decides what to ask next — random search, Bayesian optimization, gradient methods, LLM agents. Between them sits the framework’s one structural commitment: cost is a first-class primitive. Every oracle query and every driver decision is priced in heterogeneous currencies and charged against a single campaign Budget.

Installation

pip install cadaques

Guide

• Quickstart
• Concepts
  • The dual architecture
  • Declared vs. settled cost
  • Both sides are metered
  • Budget-aware strategies
  • Multi-currency budgets

Reference

• Core
  • Protocols
  • Cost and budget
  • Campaign
  • Ledger
• Oracles
  • AnalyticOracle
  • quadratic_bowl()
  • T_C_EXACT
  • Ising2DOracle
• Drivers
  • RandomDriver
  • AnnealedLocalDriver

Citation

If you use CADAQUES in academic work, please cite it: doi:10.5281/zenodo.21293589.