Luna 1.0

Luna 1.0.8¶

Released on November 13, 2025

🚀 New Features¶

• Added CudaqCpu and CudaqGpu backends for the QAOA algorithm.

🛠️ Improvements¶

• Minor bug fixes and performance improvements.

Luna 1.0.7¶

Released on October 6, 2025

🛠️ Improvements¶

• Optimized model building for faster performance and improved overall efficiency.

Luna 1.0.6¶

Released on October 2, 2025

📊 Dashboard Upgrade: Jobs & Models¶

The Luna Admin Dashboard has been updated with improvements to the Jobs and Models tabs. This release delivers deeper insight into your optimization runs through integrated analytics and complete traceability, streamlining your workflow for greater clarity and control.

📈 Jobs Tab: Unified view with integrated analytics¶

• View job status in real time, including detailed metadata and clear indicators.
• Explore results with feasibility ratios and energy/objective distributions.
• Manage your jobs directly: view details, remove old runs, or access associated models.

🔍 Models Tab: Connect model design with performance¶

• Assess model complexity with constraint and variable counts, and objective function details.
• Track performance across all related jobs and results in one view.
• Maintain full traceability with creation and update timestamps.

🛠️ Improvements¶

• The best_sample_idx property on Solution objects now accounts for feasibility.
• Added Conditional Value at Risk (CVaR) on Solution objects.
• Fixed implicit 1.0 coefficients in quadratic objectives and improved stability in LpTranslator.

Luna 1.0.5¶

Released on September 22, 2025

🐛 Bug Fixes¶

• Minor bug fixes and performance improvements

Luna 1.0.4¶

Released on August 18, 2025

🛠️ Improvements¶

• Add new Expression methods:
  • Retrieve items by order: linear_items, quadratic_items, higher_order_items.
  • Check order properties: is_constant, has_quadratic, has_higher_order.
• Quickly clone a Model with all its configurations using deep_clone.
• Add a variable safely using add_variable_with_fallback, which automatically appends a unique suffix if a name conflict occurs.
• Filter a Solution with filter to return only the samples/results matching the given condition.
• Add variables to a solution with add_var (single) or add_vars (multiple).
• The obj_values and raw_energies properties of a Solution now return either a numpy array or None(previously, they always returned a NumPy array containing None values).

Luna 1.0.3¶

Released on August 4, 2025

🐛 Bug Fixes¶

• Removed legacy QCtrl.IBMQ access schema: QCtrl.IBMCloud is now the sole supported IBM integration
• minor bug fixes

Luna 1.0.2¶

Released on July 16, 2025

🐛 Bug Fixes¶

• Minor bug fixes and performance improvements

Luna 1.0.1¶

Released on July 9, 2025

🆕 Luna Admin Dashboard Now Live at app.aqarios.com¶

The Luna Admin Dashboard is now live, providing a single, simple interface to manage your Luna workflows, API access, tokens, and organization settings. Whether you're new to Luna or already familiar, this release makes setup and day-to-day management much smoother.

✨ What’s New¶

🧭 Streamlined Sign-Up & Onboarding¶

Getting started with Luna is now easier than ever:

• 📝 Sign up with a quick, guided web form
• 🔑 Instantly generate your Luna API Key during onboarding
• 🚧 Go from account creation to building workflows in just a few minutes

🏢 Organization Management¶

• 👥 Manage users, groups, and group-level tokens yourself directly from the dashbaord
• 🔒 Note: Free-tier users are currently limited to 1 user and 1 group

🎫 QPU Token Management¶

• 🧑‍💻 Manage personal tokens in the dashboard and directly use them in the SDK
• 👨‍👩‍👧 Share tokens within groups for collaborative access

📊 Quota Overview¶

• ⏱️ View your current job time quota per month

🧪 Coming Soon¶

We're actively working on expanding the dashboard to include:

• A dashboard overview of your jobs, models, and circuits
• Jobs and solutions history with metadata and convenience tools
• Further insights into the results for your models

Stay tuned — there's much more on the way! 🚀

🚀 New Features¶

• 🧮 Enhanced SDK Features:

  • New convenience utilities for a Solution instance:

    • directly compute the expectation_value, feasibility_ratio or highest_constraint_violation,
    • filter a Solution for only it's feasible samples using solution.filter_feasible(),
    • the Solution.from_counts(...) method to create a new Solution from a dict that maps measured bitstrings to counts,
    • Improved string representations with enhanced customizability using the solution.print(...) method.

  • Add and get variables directly on a Model instance with the model.add_variable(...) and model.get_variable(...) methods.

  • Iterate over an Expression (a Model's objective or the left-hand side of a Constraint) using the .items() method for structured access to the expression's terms:

    from luna_quantum import Constant, Expression, HigherOrder, Linear, Quadratic
    
    ...
    
    expr: Expression = ...
    for term, bias in expr.items():
        match term:
            case Constant():
                handle_constant(bias)
            case Linear(x):
                handle_linear(x, bias)
            case Quadratic(x, y):
                handle_quadratic(x, y, bias)
            case HigherOrder(ho):
                handle_higher_order(ho, bias)
    

  ---

🛠️ Improvements¶

• 📘 Luna Docs Enhancements

  • Improved explanations (e.g., Dialectic Search)
  • Examples updated with real, working code
  • Minor visual and readability improvements
  • Dark Mode in Luna Docs for a more comfortable and accessible reading experience

• 🧰 SDK Usability Updates

  • Cleaned up docstrings and links
  • Improved formatting for printing Solution objects with customization support
  • Clearer error messages with hybrid job diagnostics

🐛 Bug Fixes¶

• Introduced DuplicateConstraintNameError that is raised when a duplicate constraint name is used
• Fixed timezone compatibility issue
• Enhanced error logging for failed jobs to provide better debugging insights
• Fixed broken links in docstrings

Luna 1.0.0¶

⚠️ 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.

🚀 New Features¶

• 📦 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.

🛠️ Improvements¶

• 🔄 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.

🐛 Bug Fixes¶

• 🕒 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