> ## Documentation Index
> Fetch the complete documentation index at: https://docs.astrobee.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Build a data layer and ask questions about your data in minutes

In this quickstart, you'll load demo e-commerce data, watch AstroBee build a semantic data layer, and ask business questions in plain English—all in under 10 minutes.

<Info>
  **Prerequisites**: [Create an account](https://app.astrobee.ai) and sign in before you begin.
</Info>

## Load Demo Data

After signing in, you'll land on the **Data Hub**. For new accounts, AstroBee offers demo datasets to help you explore the platform.

<Frame caption="The Data Hub shows options to load demo data or connect your own">
  <img src="https://mintcdn.com/astrobee-f4b330e6/ppM7q3dJGmeBWRIe/screenshots/02-data-sources-clean.png?fit=max&auto=format&n=ppM7q3dJGmeBWRIe&q=85&s=9027096f75d57fe2c2febbb2522e60f9" alt="Data Hub with demo data options" width="2850" height="1608" data-path="screenshots/02-data-sources-clean.png" />
</Frame>

Click **Basic E-Commerce** to load a pre-configured dataset with:

* **Customers** — Customer information and purchase history
* **Products** — Product catalog with categories and pricing
* **Orders** — Transaction records linking customers to products

<Frame caption="Demo data loading with pattern analysis">
  <img src="https://mintcdn.com/astrobee-f4b330e6/ppM7q3dJGmeBWRIe/screenshots/16-data-source-with-data.png?fit=max&auto=format&n=ppM7q3dJGmeBWRIe&q=85&s=0ccee4e3978793786377ec95a27dbbde" alt="Loading demo data" width="2850" height="1608" data-path="screenshots/16-data-source-with-data.png" />
</Frame>

Once loaded, AstroBee automatically:

1. **Analyzes patterns** in your data columns (e.g., ID formats, email patterns)
2. **Discovers linkages** between tables (e.g., `orders.customer_id` → `customers.customer_id`)

## Explore Your Data

Click on any table to preview its data and see discovered patterns:

<Frame caption="Table preview showing customer data">
  <img src="https://mintcdn.com/astrobee-f4b330e6/ppM7q3dJGmeBWRIe/screenshots/17-table-detail.png?fit=max&auto=format&n=ppM7q3dJGmeBWRIe&q=85&s=ba347065b528201be827495e3f7da9ca" alt="Table detail view" width="2850" height="1608" data-path="screenshots/17-table-detail.png" />
</Frame>

### Pattern Analysis

AstroBee automatically identifies patterns in your columns. Click the pattern icon next to a column to see details:

<Frame caption="Pattern analysis showing Customer ID format">
  <img src="https://mintcdn.com/astrobee-f4b330e6/ppM7q3dJGmeBWRIe/screenshots/18-column-patterns.png?fit=max&auto=format&n=ppM7q3dJGmeBWRIe&q=85&s=8967feffe07b370733f1fb82d6def125" alt="Column patterns" width="2850" height="1608" data-path="screenshots/18-column-patterns.png" />
</Frame>

Pattern analysis helps AstroBee understand your data semantics and suggest appropriate entity mappings.

## Build Your Data Layer

Navigate to **Data Layer** in the sidebar. This is where you define how your business concepts map to your raw data.

### Connect Data Sources

1. Click the **Sources** tab
2. Click **Connect** next to your E-Commerce data source

<Frame caption="Connect data sources to your data layer">
  <img src="https://mintcdn.com/astrobee-f4b330e6/ppM7q3dJGmeBWRIe/screenshots/20-data-layer-sources-available.png?fit=max&auto=format&n=ppM7q3dJGmeBWRIe&q=85&s=4589b7f9133f97eb92730d4531c85f6e" alt="Sources tab" width="2850" height="1608" data-path="screenshots/20-data-layer-sources-available.png" />
</Frame>

### Generate with AI

Click **Generate Data Layer from selected Sources**. AstroBee's AI will ask a few questions to understand your business:

<Frame caption="AstroBee asks about your primary business questions">
  <img src="https://mintcdn.com/astrobee-f4b330e6/ppM7q3dJGmeBWRIe/screenshots/22-generating-data-layer.png?fit=max&auto=format&n=ppM7q3dJGmeBWRIe&q=85&s=f972e77deb8c91bc35eb61f8f96197e0" alt="Generation questionnaire" width="2850" height="1608" data-path="screenshots/22-generating-data-layer.png" />
</Frame>

Select your answers and AstroBee will:

1. Analyze your connected data sources
2. Identify entities (Customer, Product, Order, OrderItem)
3. Map relationships between them
4. Bind entities to source tables

<Frame caption="Generated data layer summary">
  <img src="https://mintcdn.com/astrobee-f4b330e6/ppM7q3dJGmeBWRIe/screenshots/25-data-layer-generated.png?fit=max&auto=format&n=ppM7q3dJGmeBWRIe&q=85&s=33012085c9fecd1c0fff7d9d65fef8a1" alt="Generation complete" width="2850" height="1608" data-path="screenshots/25-data-layer-generated.png" />
</Frame>

### Review the Graph

Switch to the **Data Layer** tab to see your entities visualized:

<Frame caption="Graph view showing entity relationships">
  <img src="https://mintcdn.com/astrobee-f4b330e6/ppM7q3dJGmeBWRIe/screenshots/26-data-layer-graph.png?fit=max&auto=format&n=ppM7q3dJGmeBWRIe&q=85&s=0c904c0299e4a3ca30f009c8336c517b" alt="Data layer graph" width="2850" height="1608" data-path="screenshots/26-data-layer-graph.png" />
</Frame>

The graph shows:

* **Customer** (dimension) — Individual customers
* **Product** (dimension) — Products in your catalog
* **Order** (fact) — Customer transactions
* **OrderItem** (bridge) — Line items linking orders to products

### Review and Publish

Click **Review** to see all pending changes before publishing:

<Frame caption="Review panel showing entities and relationships to publish">
  <img src="https://mintcdn.com/astrobee-f4b330e6/ppM7q3dJGmeBWRIe/screenshots/28-review-panel.png?fit=max&auto=format&n=ppM7q3dJGmeBWRIe&q=85&s=2cd9cd83c6bba56789ec89dc12937bfc" alt="Review panel" width="2850" height="1608" data-path="screenshots/28-review-panel.png" />
</Frame>

Click **Publish all pending changes** to make your data layer active.

## Ask Questions

With your data layer published, you're ready to ask questions! Click **New Chat** in the sidebar.

<Frame caption="Chat interface ready for questions">
  <img src="https://mintcdn.com/astrobee-f4b330e6/ppM7q3dJGmeBWRIe/screenshots/29-published-data-layer.png?fit=max&auto=format&n=ppM7q3dJGmeBWRIe&q=85&s=ee5ab3a69d6815aabfa9f85c7338efb5" alt="New chat" width="2850" height="1608" data-path="screenshots/29-published-data-layer.png" />
</Frame>

Type a question in plain English:

```
How many customers do we have?
```

<Frame caption="AstroBee answers with the result">
  <img src="https://mintcdn.com/astrobee-f4b330e6/ppM7q3dJGmeBWRIe/screenshots/31-chat-response.png?fit=max&auto=format&n=ppM7q3dJGmeBWRIe&q=85&s=9e09073ceef00c4da3b5e3b9b0bd113e" alt="Chat response" width="2850" height="1608" data-path="screenshots/31-chat-response.png" />
</Frame>

### View the SQL

Click **SQL** to see the exact query AstroBee generated:

<Frame caption="Generated SQL query">
  <img src="https://mintcdn.com/astrobee-f4b330e6/ppM7q3dJGmeBWRIe/screenshots/32-chat-sql-view.png?fit=max&auto=format&n=ppM7q3dJGmeBWRIe&q=85&s=1daf0053af85f4f9c22c1612fbc63ca4" alt="SQL view" width="2850" height="1608" data-path="screenshots/32-chat-sql-view.png" />
</Frame>

### Understand the Logic

Click **Logic** to see how AstroBee reasoned through your question:

<Frame caption="Explanation of how the answer was derived">
  <img src="https://mintcdn.com/astrobee-f4b330e6/ppM7q3dJGmeBWRIe/screenshots/33-chat-logic-view.png?fit=max&auto=format&n=ppM7q3dJGmeBWRIe&q=85&s=10ab45f02f6c6ad5793a9ea84d151d4c" alt="Logic view" width="2850" height="1608" data-path="screenshots/33-chat-logic-view.png" />
</Frame>

### Full Report

Click **Full Report** for a complete breakdown:

<Frame caption="Complete answer report with question, answer, SQL, and logic">
  <img src="https://mintcdn.com/astrobee-f4b330e6/ppM7q3dJGmeBWRIe/screenshots/34-chat-full-report.png?fit=max&auto=format&n=ppM7q3dJGmeBWRIe&q=85&s=5363b7f3808cc9ca1c78f6e023ced285" alt="Full report" width="2850" height="1608" data-path="screenshots/34-chat-full-report.png" />
</Frame>

## Try More Questions

Now explore your data with more questions:

```
What are our top 5 products by total revenue?
```

```
Show me customers who have placed more than 2 orders
```

```
What's the average order value by product category?
```

Each answer shows the SQL and logic, so you always understand how AstroBee arrived at the result.

## Next Steps

<CardGroup cols={2}>
  <Card title="Connect Your Data" icon="plug" href="/data/overview">
    Connect your own data sources—files, databases, or business tools
  </Card>

  <Card title="Data Layer Deep Dive" icon="sitemap" href="/features/data-layer">
    Learn more about editing and versioning your data layer
  </Card>

  <Card title="Analytics Features" icon="chart-bar" href="/features/analytics">
    Explore charts, exports, and advanced query features
  </Card>

  <Card title="MCP Integration" icon="terminal" href="/features/mcp">
    Query your data from Claude Desktop or VS Code
  </Card>
</CardGroup>

**Need help?** Contact us at [hello@astrobee.ai](mailto:hello@astrobee.ai).
