# 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


**Supported Browsers:** See [Browser Support for TD 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 Data 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

| 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