Skip to main content

Settings

The Settings panel is where you manage API access and connected compute resources. Open it by clicking Settings in the navigation bar (visible when signed in).

API Keys​

API keys let the Python SDK and BYOC controllers authenticate with Atomiverse. There are two key types:

Key typePurpose
Workspace keyFull API access for the Python SDK and user-facing API calls.
Runner keyRestricted to BYOC controller registration. Use this when setting up a controller on your own machine.

Key List​

Each key appears as a row showing its name, prefix, type, creation date, and status:

Access

API Keys

Create keys to access the Atomiverse API programmatically.

production
sk-av••••••••x8m2… Workspace key · Mar 14, 2026
ActiveRevoke
dgx-runner
sk-rn••••••••p3k9… Runner key · Apr 2, 2026
ActiveRevoke
old-dev
sk-av••••••••z7q1… Workspace key · Jan 20, 2026
RevokedDelete
  • Active keys show a green badge and a Revoke button. Revoking permanently disables the key — any application using it loses access immediately.
  • Revoked keys show a grey badge and a Delete button. Deleting removes the key record entirely.

Creating a Key​

Click New Key to open the creation form. You provide:

  • Key name — a human-readable label like production or local-dev (up to 64 characters)
  • Key type — workspace or runner

After creation the full key secret is displayed once. Copy it immediately — once you dismiss the reveal dialog the secret is not retrievable. Store it somewhere secure.

Controllers​

BYOC controllers are machines you connect to run jobs on your own hardware.

Controller List​

Each controller appears as a row showing its name, hardware specs, live resource usage, last-seen time, and status:

BYOC

Controllers

Connect your own machines to run jobs on your hardware.

dgx-01
64 cores · 256 GB · 3 jobs active · last seen May 2, 14:32
CPU14 / 64 cores
Memory48 / 256 GB
OnlineRemove
hpc-cluster
32 cores · 128 GB · 7 jobs active · last seen May 8, 10:15
CPU28 / 32 cores
Memory96 / 128 GB
OnlineRemove
lab-cluster
32 cores · 128 GB · last seen Apr 25, 09:15
OfflineRemove
  • Online controllers have a blue pulsing badge and show live resource meters. The meters display current CPU and memory usage against the configured maximums (e.g. 14 / 64 cores).
  • Resource meters use three color levels: blue/purple for normal usage, amber when above 70%, and red when above 90%.
  • Offline controllers have a grey badge and do not show resource meters. They reconnect automatically when the controller process starts again.

Click Remove to disconnect a controller. Jobs already submitted to that controller will no longer run there.

Empty State​

When no controllers are connected, a placeholder card with setup instructions is shown:

BYOC

Controllers

Connect your own machines to run jobs on your hardware.

No controllers connected
Install the controller on your machine to get started.

Setup​

Install the controller on your machine:

pip install https://atomiverse.com/packages/atomiverse-controller

Then run the setup wizard:

atomiverse-controller setup

Use a Runner key during setup. The controller appears in the list automatically once it connects.

Session Chip​

The top-right chip displays your account name, email, and current core-hour balance — the same chip shown across all dashboard pages.

Rotating keys

Create a new key before revoking the old one so your SDK scripts or controllers have no downtime.

Key storage

Atomiverse only stores a key prefix after creation. If you lose the full secret you must create a new key.