Skip to content

Luna 1.0

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 is now live!

Luna Admin Dashboard is now live at app.aqarios.com, providing easier access to your Luna workflows. Learn more here

🆕 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

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.

🚀 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