Quick Start

This guide walks you through first-time setup on macOS or Windows.

1. Download & install

Get the installer from Download or GitHub Releases.

• macOS: .dmg or Homebrew brew install --cask ember
• Windows: Ember_*_x64-setup.exe

2. Configure an AI provider

Ember does not ship AI models. Bring your own API keys:

1. Open Ember → AI provider settings
2. Pick a provider (OpenAI-compatible, Anthropic, etc.)
3. Enter your API key and test connection
4. Save your preferred models

See AI Providers for details.

3. Create your first test task

1. From home, click New task
2. Enter a goal, e.g. “Plan regression scope for v2.3 RC”
3. Attach PRD excerpts, API notes, or known defects
4. Choose a model and generate scope or case structure
5. Iterate in the same task and save results to project context

4. Optional: mobile validation

For device or emulator checks, open the Mobile testing workspace and connect Android / iOS / HarmonyOS devices.

5. Optional: Ember Cloud

If your team runs Ember Cloud (private deployment), use UI-Genie for cloud-device NL automation or ember-mcp from Cursor.

Next steps

• Installation
• Workspace
• FAQ