Luna 1.0.0¶

Warning

🚨 Breaking Changes Included – Released on June 4, 2025

⚠️ Breaking Changes¶

SDK Restructuring
We’ve restructured our SDK to streamline integration, reduce boilerplate, and significantly improve both the developer experience and configuration flexibility. Please note that this update is not backward compatible with previous versions of the SDK.

📦 Unified Model Component for Format Independence
Introducing the new Model component, designed for seamless format conversion without compromising efficiency. Easily import from and export to various model formats. Learn more in the Model Introduction.
🧠 FlexQAOA — A Dedicated Aqarios Algorithm
Say hello to FlexQAOA, our constraint-native quantum algorithm built to solve real-world complexity at scale. Explore its capabilities in our FlexQAOA guide.
📘 Revamped Documentation
Alongside the SDK update, we’ve launched a fully revamped documentation site. It provides comprehensive coverage of our services — LunaSolve, LunaBench, and LunaQ — as well as our core components: Algorithms, Backends, Model, and Solution. The documentation now includes even more comprehensive SDK and API references to easily find what you are looking for.

🔄 Real-Time Feedback During Tasks
You’ll now see clear messages and spinners when the SDK is doing something time-consuming—like uploading a model or contacting the server. This keeps you informed and removes the guesswork, so you’re never left wondering if something is stuck.
📜 Improved Logging Experience
The SDK now provides well-structured logs that are easier to read and follow. If you prefer a more visual experience, you can enable rich formatting with the rich library for color-coded messages, tables, and better debugging. This makes it simpler to understand what’s happening behind the scenes.
⚡ Quick SDK Version Check
A new utility lets you instantly print the SDK version you’re using. This helps with troubleshooting, staying up to date, and sharing precise setup details with your team or support—no more digging into config files.

🕒 Consistent, Readable Log Timestamps
We’ve updated our logging format to use the internationally recognized ISO 8601 style: This improves readability and aligns with common developer expectations. We’ve also updated log level indicators (e.g. [INFO], [DEBUG]) to appear in brackets for a cleaner, more standard logging layout.
🚫 Missing API Key Warning
When an API key is missing, the SDK now provides a clear, immediate error message in the console—so you’ll know exactly why things aren’t working