Luma Cloud Docs

SuperGPT setup

Luma Cloud in your desktop workspace.

Choose Luma Cloud models in your app. Manage your Luma account from the menu bar or Windows system tray.

Before you start

Open SuperGPT in your dashboard to check the current download and requirements. You need a compatible desktop app and a Luma Cloud account. The Mac helper requires Apple Silicon and macOS 14 or later.

Depending on its release, Codex desktop may be named Codex or ChatGPT. ChatGPT Classic is not supported. Keep your existing OpenAI account signed in.

SuperGPT for Windows x64 is available from your dashboard. Follow the Windows steps below.

Intel Mac installers are not offered. To use Luma Cloud through an API client on another platform, choose a supported integration instead.

Get connected on Mac

  1. Check compatibility.

    Read the requirements on the dashboard. Save your work and let active tasks finish before following a prompt to close the desktop app.

  2. Install SuperGPT.

    Download it from your dashboard when available. Open the disk image, then open the installer inside. On first launch, follow the Open Anyway steps below, then return to the installer and continue setup. If no compatible download is offered, wait for availability or contact support.

  3. Sign in to Luma Cloud.

    Open the Luma Cloud icon in the macOS menu bar and choose Sign in. Use the account that holds your subscription.

  4. Choose a model.

    Return to your desktop app and select an available Luma Cloud model for a new task. Your OpenAI and Luma Cloud accounts and allowances stay separate.

Signing in connects your account. Sending requests also requires an active Luma Cloud subscription with enough allowance. An API Wallet key is for the separate API setup.

Get connected on Windows

  1. Check your desktop app.

    Use ChatGPT desktop with local Work tasks or the separate Codex desktop app. Cloud tasks do not use this integration. Save your work and let active tasks finish before closing the app for setup.

  2. Install SuperGPT.

    Download the Windows EXE from your dashboard when offered. The EXE is currently unsigned, so Windows may ask you to confirm opening it. Open it and let setup find and verify your compatible desktop app. Choose Install, then use setup to open ChatGPT/Codex and SuperGPT.

  3. Sign in to Luma Cloud.

    Open the Luma Cloud system tray icon and choose Sign in. Use the account that holds your subscription. Click the small monochrome tray icon to see three usage bars in the popup. The installer uses the full-color logo.

  4. Choose a model.

    Return to your desktop app and select an available Luma Cloud model and effort for a new or existing local task. Your existing OpenAI sign-in and chats stay in place. Your OpenAI and Luma Cloud accounts and allowances stay separate.

When an update is available, a blue update button appears in the tray popup. Open it to download and follow progress. When it is ready, save your work, finish active tasks and follow the Apply prompt. SuperGPT and the official desktop app keep their own updates.

First launch: Open Anyway

This installer does not use an Apple Developer ID certificate and is not notarized by Apple. macOS may say that the developer cannot be verified or that Apple cannot check the app. If you choose to continue, use the installer downloaded directly from your Luma Cloud dashboard.

  1. Try opening the installer first.

    Open the downloaded disk image and double-click the installer inside. Dismiss the developer-verification warning without moving the installer to the Trash.

  2. Open Privacy & Security.

    From the Apple menu, open System Settings, select Privacy & Security and scroll to Security. Find the message for the installer and click Open Anyway.

  3. Confirm and continue.

    Choose Open in the confirmation dialog. If macOS asks, enter your Mac login password in the system prompt. Return to the installer and follow its setup steps.

This creates an exception for this app. You do not need a Terminal command or a change to your Mac’s general app-security settings. See Apple’s illustrated guide to opening downloaded apps.

Your Luma Cloud menu

The menu shows your account, plan and remaining quota. Standard and Premium are separate; if your plan includes a five-hour limit, it appears with the quota it applies to.

Usage refreshes automatically. Dashboard opens your account on the website, where you can manage your plan and purchase additional quota when available.

Keep up to date

When a compatible Luma update is available, a blue download button appears in the menu. Select it to follow download and installation progress. If the app needs to close or restart, follow the prompt after saving your work.

Your saved Luma sign-in stays in place. After an update, macOS may ask to let the sign-in helper, named “stock-keychain”, use it. Enter your keychain password in that system dialog—usually your Mac login password. Choose Always Allow to remember access for this helper; Allow grants access for that attempt only. About macOS Keychain permissions.

Codex desktop keeps its own updates. A new desktop version can require a Luma compatibility update. If Luma models are unavailable after an update, check your dashboard and the Luma menu for an updated helper.

If something does not look right

Open Anyway is missing
Try opening the installer again, then return to Privacy & Security. The button is available for about an hour after the attempt. A work-managed Mac may require help from your administrator.
macOS says the installer is damaged or will harm your Mac
Do not use the steps above to override that warning. Delete the downloaded installer, download it again from your dashboard and contact support if the warning remains.
The wrong account appears
Sign out from the Luma Cloud menu, then sign in with the email used for your subscription.
Usage is unavailable
Check your connection and let the menu refresh. You can also open Usage in your dashboard. An unavailable reading does not mean the allowance is empty.
Luma models are missing
Check that Luma Cloud is signed in and that your subscription is active. If the desktop app recently updated, check for a helper update.
Setup or an update stops
Keep the error message and contact support. Do not delete your chat history or sign out of your OpenAI account as a troubleshooting step.