Skip to main content

​
Try online

Select Try Qualia Online on the overview page to open Qualia Cloud in your browser.

​
Download and install

Download the desktop app from the download page.
On an Apple Silicon Mac (M1 or newer), download the DMG. The file is named qualia-*-macos-apple-silicon.dmg. Intel Macs are not supported.Open the DMG and drag Qualia to your Applications folder. On first launch, macOS may ask you to confirm since the app was downloaded from the internet.
Qualia checks for updates automatically on launch and prompts you when a new version is available.

​
Sign in

In your browser, choose Continue with SSO or another Continue with account option. The same form handles new and returning users. After signing in, Qualia returns you to the page you were opening. If sign-in fails, choose Return to login to retry. On desktop, choose Sign in with SSO or a Continue with option to open browser sign-in. When finished, choose Continue to Qualia to return to the app. The sign-in footer links to the Terms and Privacy Policy. For an enterprise deployment, choose enter your activation key and paste the key provided by your administrator. Activation requires internet access to quadrillion.ai. If the key is rejected, ask your administrator to check it.

​
Set up a Python kernel

During onboarding, Qualia installs a managed Jupyter environment to run Python notebooks locally. Installation needs internet access to download Python packages. If the installation fails:
  • Skip for now lets you finish onboarding without a local kernel. You can install it later, or connect to remote compute instead.
  • The error shown under Installation failed is the installer’s real output — share it with your IT team to identify what was blocked.
  • On networks that intercept TLS with a corporate certificate, launch Qualia with UV_NATIVE_TLS=1 set (to trust your OS certificate store) or point SSL_CERT_FILE at your corporate root CA bundle. Set HTTPS_PROXY if your network requires an explicit proxy.
  • On machines where security policy blocks downloaded programs from running, install a Python 3.12 or newer approved by your IT team: the installer finds and uses it instead of downloading its own Python.
  • If Python package downloads are blocked entirely, a Jupyter environment already installed on your PATH (with jupyter and ipykernel) is used instead, skipping the managed install.

​
Open a workspace

If Get Started with Qualia appears, enter your Name and Company, then click Continue to open your workspace. In the desktop app, the welcome screen lets you pick a recent workspace, choose New folder… to create a fresh workspace folder (you pick its name and location), or choose Open folder… to use an existing one. You can also use the workspace selector in the title bar to open a local folder or connect to a remote backend. When you are connected to a remote backend, Open remote folder lets you browse directories on that remote machine and choose the workspace root without restarting Qualia. In Qualia Cloud, the Workspaces page shows workspace cards. Use Search or the All, My workspaces, and Shared with me tabs to find one. Click a card to open it, or choose New workspace. Each workspace has its own link, so you can bookmark it or keep different workspaces open in separate browser tabs. Files, agents, tasks, and knowledge belong to their workspace. The header shows your organization and plan, a Settings button, and the account menu, which shows your usage this period and signs you out; see Your account and organization. Workspace cards show previews of recent work. A new workspace may have a blank preview until an agent completes its first turn. Inside a workspace, use the titlebar workspace selector to open a recent workspace or create one. Choose All workspaces to return to the Workspaces page. If loading fails, choose Try again. Open a workspace card’s … menu on the Workspaces page or in the titlebar selector to Rename or Delete your workspace, or Leave a shared one. Stop any running agents first. Deletion permanently removes the workspace’s files, chats, tasks, knowledge, and compute. Connected integrations remain on your account; new conversations arrive in another workspace. If deletion is unavailable, the tooltip explains that the workspace cannot be deleted. If a workspace link cannot be opened, Qualia offers the relevant next step: verify your email, switch accounts, or return to All workspaces.
Remote folder browsing uses the filesystem on the connected backend host, not your local computer.

​
Your first session

1

Create a notebook

Click New Notebook in the Files sidebar, or open an existing .ipynb file.
2

Start chatting

Type a message in the chat panel on the right. Try something like:
  • “Load the iris dataset and show me a summary”
  • “Train some CNNs on the MNIST dataset”
3

See results

Qualia writes code cells, runs them, and shows the output — plots, tables, text — directly in the notebook. You can see and edit every cell it creates.
Toggle the chat panel with Cmd+K (Mac) or Ctrl+K (Windows/Linux).