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

# Quickstart

Get started with Bag of words in minutes. Install, configure, and start chatting with your data.

## Install with Docker

You can install Bag of words with a single docker command. By default, it will use SQLite as the database.
You can also configure it to use PostgreSQL by passing `BOW_DATABASE_URL` environment variable.

```bash theme={null}
docker run --pull always -d -p 3000:3000 bagofwords/bagofwords
```

<Info>
  To use PostgreSQL, you need to set the `BOW_DATABASE_URL` environment variable.
  For example: `BOW_DATABASE_URL=postgresql://postgres:postgres@localhost:5432/bagofwords`
</Info>

## Onboarding

After installation, complete the onboarding flow to set up your AI analyst.

### 1. Welcome

Start by clicking **Next** to begin the setup process.

<img src="https://mintcdn.com/bagofwords/EbTwBzDiBUd0Y1I4/assets/media/onboarding/welcome.png?fit=max&auto=format&n=EbTwBzDiBUd0Y1I4&q=85&s=05b82b4256641e76e2669f7a14222230" alt="Welcome to Bag of words" width="1520" height="990" data-path="assets/media/onboarding/welcome.png" />

### 2. Configure LLM

Connect to any LLM provider and bring your own API key. Choose from OpenAI, Anthropic, Azure OpenAI, or Google.

<img src="https://mintcdn.com/bagofwords/LAdg09T4Ov37V_62/assets/media/onboarding/llm.png?fit=max&auto=format&n=LAdg09T4Ov37V_62&q=85&s=5a5057bf950417c7c468a4e81631114a" alt="Configure LLM" width="1520" height="990" data-path="assets/media/onboarding/llm.png" />

### 3. Connect Data Source

Select one of the available data sources: PostgreSQL, Snowflake, BigQuery, MySQL, AWS Athena, Salesforce, and more.

<img src="https://mintcdn.com/bagofwords/LAdg09T4Ov37V_62/assets/media/onboarding/data-source.png?fit=max&auto=format&n=LAdg09T4Ov37V_62&q=85&s=e532cb687c660c54d1d123df292e6c0a" alt="Connect data source" width="1520" height="990" data-path="assets/media/onboarding/data-source.png" />

Enter your connection details (host, port, database, credentials) and test the connection.

### 4. Select Tables

Choose which tables the AI can access and query during conversations. You can select all or specific tables based on your needs.

<img src="https://mintcdn.com/bagofwords/EbTwBzDiBUd0Y1I4/assets/media/onboarding/tables.png?fit=max&auto=format&n=EbTwBzDiBUd0Y1I4&q=85&s=e32f37ed3118bedd4e5e2192b2ded486" alt="Select tables" width="1520" height="990" data-path="assets/media/onboarding/tables.png" />

### 5. Add Context

Add custom instructions and enrich context to help the AI make better decisions. You can:

* **Suggest Instructions**: Add business-specific context, glossary, and code guidelines
* **Enrich Context**: Connect Git repos to load dbt/markdown resources, then toggle items to include them in AI context

<img src="https://mintcdn.com/bagofwords/LAdg09T4Ov37V_62/assets/media/onboarding/context.png?fit=max&auto=format&n=LAdg09T4Ov37V_62&q=85&s=469556f34fb58ba3e721cd7a03efb611" alt="Add context" width="1520" height="990" data-path="assets/media/onboarding/context.png" />

### 6. Start Asking Questions

Setup complete! You can now start asking questions in natural language. Create reports, dashboards, and get the data you need.

<img src="https://mintcdn.com/bagofwords/LAdg09T4Ov37V_62/assets/media/onboarding/ready.png?fit=max&auto=format&n=LAdg09T4Ov37V_62&q=85&s=7103cc37d843561e28362e5a5233da27" alt="AI Analyst ready" width="1520" height="990" data-path="assets/media/onboarding/ready.png" />

Use the conversation starters or type your own questions to begin analyzing your data.

## Next Steps

**Learn how to use Bag of words:**

<CardGroup cols={3}>
  <Card title="Chat with Data" icon="bot" href="/using-bow/reports">
    Learn how to ask questions and iterate on results
  </Card>

  <Card title="Create Dashboards" icon="chart-pie" href="/using-bow/dashboards">
    Build visual stories with charts and tables
  </Card>

  <Card title="Add Instructions" icon="box" href="/using-bow/instructions">
    Guide your AI with custom business rules
  </Card>
</CardGroup>

**Understand how it works:**

<CardGroup cols={2}>
  <Card title="Agent Architecture" icon="brain" href="/core/agent">
    Deep dive into the reasoning loop and tools
  </Card>

  <Card title="Context Management" icon="layers" href="/core/context">
    How Bag of words constructs context for every run
  </Card>
</CardGroup>
