# Getting Started

Go from zero to your first AI-assisted query in under five minutes. Whether you prefer a browser, a desktop app, or your phone, Studio is ready on all three.

Note
Studio authenticates through your existing Treasure AI SSO — no API keys, no separate accounts. The AI connects to your Treasure AI account automatically upon sign-in.

## Prerequisites

- A **Treasure AI account** with SSO access enabled
- Your **account region** — one of: US, Tokyo, EU01, or AP02
- AI Credits provisioned for your account (contact your Customer Success Manager if unsure)


## Supported Platforms

| Platform | Status | How to Access |
|  --- | --- | --- |
| **Web** | Available | Open in any modern browser |
| **Mac Desktop** | Available | [Download the desktop app](https://github.com/treasure-data/treasure-ai-studio-desktop/releases/latest) |
| **iOS Mobile** | Available | [Download from the App Store](https://apple.co/4uxuT0k) |


## Web & Desktop

### Web Setup

The fastest way to get started. No installation required.

- [US Region](https://agent.us01.treasure.ai/)
- [Japan Region](https://agent.ap01.treasure.ai/)
- [Europe Region](https://agent.eu01.treasure.ai/)


1. Open your browser and navigate to the Treasure AI Studio URL for your region
2. Click **Sign in with Treasure Data**
3. Complete authentication on the Treasure AI login page
4. Studio loads — you'll see the landing page with the title "Let's build something" and suggestion pills to get started


Treasure AI Studio login page with app icon and Sign in with Treasure Data button
Landing page showing chat input and suggestion pills for common tasks
**Supported Browsers:** See [Browser Support for Treasure Console](/requirements-and-limitations/browser-support-for-td-console).

### Desktop Setup (Mac)

The desktop app provides the same experience as the web version with native macOS integration.

#### System Requirements

| Requirement | Details |
|  --- | --- |
| macOS | Apple Silicon (M1 or later) required |
| Architecture | arm64 |
| Disk space | ~500 MB |


Note
Intel-based Macs are not supported.

#### Steps

1. Download the latest `.dmg` from [the Treasure AI Studio Desktop releases page](https://github.com/treasure-data/treasure-ai-studio-desktop/releases/latest)
2. Open the `.dmg` and drag **Treasure AI** to Applications
3. Launch **Treasure AI** from Applications
4. The welcome screen appears: **"Welcome to Treasure AI Studio"** with the subtitle "Select your region to sign in with Treasure Data"
5. Select your **region** — available regions show as radio buttons (e.g., **US** - United States, **Tokyo** - Japan). Unavailable regions appear grayed out with "(coming soon)"
6. Click **Sign in with Treasure Data** — your default browser opens for authentication
7. After login, the browser redirects back to the desktop app automatically
8. Studio is ready — the landing page appears


#### Menu Bar

The macOS menu bar shows **Treasure AI** with: About Treasure AI, Check for Updates..., Hide Treasure AI, Quit Treasure AI.

#### Staying Up to Date

The desktop app checks for updates automatically on launch. When a new version is available, it downloads in the background and applies on next restart. You can also check manually via **Treasure AI > Check for Updates...** in the menu bar, or toggle auto-update in **Settings > General > Auto Update**.

## Mobile (iOS)

Access Studio on the go with the iOS app. Scan the QR code or tap the button below to download.

[![Download on the App Store](/assets/white.056de2f81ff61b778a0c192dbb098f9b0416e7e8f79b119e43d11248155e597f.8a9297e8.svg)](https://apple.co/4uxuT0k)

[![QR code to download Treasure AI Studio from the App Store](/assets/qr-code.1be08d16c39821d57800d3684c200f38297ff20f590b2d991bc19359630996fa.8a9297e8.png)](https://apple.co/4uxuT0k)

1. Download **Treasure AI Studio** from the [App Store](https://apple.co/4uxuT0k)
2. Open the app — the welcome screen appears with the title **"Welcome to Treasure AI Studio"** and subtitle "Sign in with your Treasure account"
3. Under **REGION**, tap your account region (e.g., **US** - United States, **Tokyo** - Japan). Unavailable regions appear dimmed with "(coming soon)"
4. Tap **Sign in with Treasure Data**
5. Complete authentication in the in-app browser
6. The home screen appears with the header **"Treasure AI Studio"**


#### Mobile-Specific Features

- **Voice input** — Tap the microphone icon to dictate your message. An audio visualization shows recording status with elapsed time and live transcript.
- **Swipe navigation** — Swipe right to dismiss the landing view and return to the home screen.
- **Bottom sheet settings** — Tap the user icon (top-left) to open settings as a drag-to-dismiss bottom sheet.


## First Steps After Setup

### Web & Desktop

1. **Start a conversation** — Type a question in the chat input (placeholder: "Send a message..."), or click a suggestion pill like **"Query sample data"** or **"Explore databases"**
2. **Create a project** — Click the folder-plus icon next to **PROJECTS** in the sidebar
3. **Try a skill** — Activate a skill in your project settings, then ask the AI a question in that domain. For example, with the `trino` skill active, ask "Show me the top 10 customers by revenue" and the AI writes optimized SQL
4. **Explore settings** — Click your user avatar in the sidebar footer to open the Settings panel


### Mobile (iOS)

1. **Start a conversation** — Tap a suggestion on the landing view, or tap the floating new-chat button (bottom-right)
2. **Browse projects** — The home screen shows your **PROJECTS** section with chat counts per project
3. **View chats** — Tap **Recent Chats** to see standalone conversations
4. **Open settings** — Tap the user icon in the top-left corner of the header


## Interface Overview

### Web & Desktop

Full interface showing sidebar, chat area with data table, and file panel with chart dashboard
| Area | Description |
|  --- | --- |
| **Sidebar** (left) | App icon + "Treasure AI Studio" title, search bar ("Search chats..."), PROJECTS section, CHATS section, user footer with email and account info |
| **Chat area** (center) | Conversation messages, chat input with model selector |
| **File panel** (right) | File previews, charts, tables, and generated documents (toggle with the file panel button) |


### Mobile (iOS)

| Area | Description |
|  --- | --- |
| **Header** | User icon / settings (left), "Treasure AI Studio" title (center) |
| **PROJECTS section** | List of projects with chat counts |
| **CHATS section** | "Recent Chats" entry with standalone chat count |
| **Floating action button** | New chat button (bottom-right, message-plus icon) |


## Keyboard Shortcuts (Web & Desktop)

| Shortcut | Action |
|  --- | --- |
| `Cmd+N` | New chat |
| `Cmd+P` | Switch project |
| `Cmd+O` | Search chats |
| `Cmd+\` | Toggle sidebar |
| `Cmd+,` | Settings |


## Verification

- [ ] See the landing page with the title **"Let's build something"** and four suggestion pills
- [ ] Click **"Query sample data"** and confirm the AI responds with a streaming answer
- [ ] See your email in the sidebar footer (Web/Desktop) or settings panel (Mobile)


## Troubleshooting

| Issue | Solution |
|  --- | --- |
| Can't sign in | Verify the correct region is selected for your Treasure AI account. See [SSO Login](/products/ai-studio/security/sso-login) for detailed authentication troubleshooting |
| Landing page doesn't load | Check your network connection. On Desktop, ensure macOS 14+ and Xcode command-line tools are installed |
| Suggestion pills don't appear | Refresh the page (Web) or restart the app (Desktop/Mobile). If the problem persists, start a new chat |


## Next Steps

- [SSO Login](/products/ai-studio/security/sso-login) — Detailed authentication guide
- [Core Concepts](/products/ai-studio/concepts) — Projects, models, credits, and context
- [Security](/products/ai-studio/security) — Security settings
- [Troubleshooting](/products/ai-studio/troubleshooting) — Resolve sign-in and chat response issues