Skip to content

Managing Models in Luna

AqModels is the foundation for representing optimization problems in Luna. This page explains how to upload, manage, and interact with your models using Luna's API.


📤 Uploading a Model

After defining your model, you can upload it to Luna with a single command:

model.save_luna()

Once uploaded, your model is stored securely and can be referenced in solve jobs or shared with collaborators. Once uploaded, you can access the Model Metadata.

Automatic Upload on Solve

If your model hasn’t been uploaded yet, Luna will automatically upload it the first time you submit a solve job.


📥 Downloading a Model

Need to reuse or inspect an uploaded model? Download it easily:

from luna_quantum import Model

model = Model.load_luna(model_id="<MODEL_ID>")

Modifying Uploaded Models

If you make changes to an uploaded model and submit it again, Luna will treat it as a new model. You’ll be notified and a new version will be uploaded automatically.


📄 Access Model Metadata

Each uploaded model comes with metadata that helps you track its history and permissions. The metadata includes:

  • id
  • created_by, created_at
  • modified_by, modified_at
  • read_access, write_access

To retrieve this information:

model_metadata = model.metadata

🧩 Load Solutions

To retrieve the solutions to the model from Luna:

solutions = model.load_solutions()

Please refer to the Solution Documentation for further information.


🛠️ Load Solve Jobs

To retrieve the solve jobs of the model from Luna:

solve_jobs = model.load_solve_jobs()

Please refer to the SolveJob Documentation for further information.


🗑️ Deleting a Model

To remove a model from Luna:

model.delete_luna()

Deletion is Permanent

Deleting a model will also delete all associated solve jobs and results. Make sure to back up anything important before deletion.