Configuration

Settings Overview

Open Settings via:

• macOS: Cmd + , or Atlas Studio menu → Preferences
• Windows/Linux: Ctrl + , or File → Settings

Settings are stored locally at:

• macOS: ~/Library/Application Support/Atlas Studio/preferences.json
• Windows: %APPDATA%\Atlas Studio\preferences.json
• Linux: ~/.config/Atlas Studio/preferences.json

AI Model Configuration

Atlas Studio supports multiple AI providers and model tiers.

Model Tiers

Set the default in: Settings → AI → Default Model Tier.

You can override the tier per-agent or per-prompt.

BYOM (Bring Your Own Model)

The Coding Agent is free with BYOM — use your own API key:

// Settings → AI → BYOM
{
  "provider": "openai",
  "apiKey": "sk-...",
  "model": "gpt-4o",
  "baseUrl": "https://api.openai.com/v1"
}

{
  "provider": "anthropic",
  "apiKey": "sk-ant-...",
  "model": "claude-3-5-sonnet-20241022"
}

{
  "provider": "azure_openai",
  "apiKey": "YOUR_AZURE_KEY",
  "baseUrl": "https://YOUR_RESOURCE.openai.azure.com",
  "deploymentId": "gpt-4o",
  "apiVersion": "2024-02-01"
}

{
  "provider": "ollama",
  "model": "llama3.2",
  "baseUrl": "http://localhost:11434"
}

Data Directory

By default, Atlas Studio stores its SQLite database and local data in:

Custom data directory

Set ATLAS_DATA_DIR environment variable before launching:

# macOS / Linux
ATLAS_DATA_DIR=/mnt/shared/atlas-studio /Applications/AtlasStudio.app/Contents/MacOS/AtlasStudio
 
# Windows (PowerShell)
$env:ATLAS_DATA_DIR="D:\SharedAtlasData"
& "C:\Program Files\Atlas Studio\AtlasStudio.exe"

This is useful for:

• Pointing multiple IDE instances at a shared dataset
• Storing data on a faster NVMe drive
• Enterprise-managed profile paths

Web Portal Connection

The Desktop IDE can connect to your Web Portal to sync workflows, credentials, and team settings.

Settings → Web Portal → Portal URL → https://studio.atlastechlab.com

Once linked:

• Workflows created locally sync to the Web Portal
• Vault credentials are available in both
• Team members can see workflow status from the portal

Telemetry and Privacy

Atlas Studio collects anonymous usage telemetry (crash reports, feature usage counters) by default.

To disable:

• Settings → Privacy → Telemetry → Off
• Or set ATLAS_TELEMETRY_DISABLED=1 environment variable

No source code, workflow definitions, credentials, or personally identifiable data is ever sent.

Environment Variables Reference

Keyboard Shortcuts