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

# Overview & Installation

> Understand what `snowglobe` is, when to use it, and the end-to-end flow to get your chatbot connected to Snowglobe.

Snowglobe Connect helps you adapt any conversational chatbot to Snowglobe’s I/O so you can run realistic simulations against your chatbot.

## When to use Snowglobe Connect

Use this flow when you want to:

* Connect an existing chatbot to Snowglobe where you need a more sophisticated interface that doesn't fit the standard OpenAI-style chat interface

## Prerequisites

* Python 3.9+ (recommend 3.10+)
* macOS, Linux, or Windows
* Optional: [uv](https://docs.astral.sh/uv/) if you prefer `uv pip`

## Installation

Install the Python package (provides the `snowglobe` CLI):

```bash theme={null}
pip install snowglobe
# or, if you use uv:
uv pip install snowglobe
```

## Verify installation

```bash theme={null}
snowglobe --version
```

<CardGroup cols={2}>
  <Card title="Authenticate" icon="key" href="/snowglobe/docs/connect/authentication" arrow>
    Log in via browser or set an API key
  </Card>

  <Card title="Initialize" icon="sparkles" href="/snowglobe/docs/connect/chatbot-initialization" arrow>
    Scaffold your chatbot wrapper
  </Card>

  <Card title="Test" icon="check" href="/snowglobe/docs/connect/test-your-wrapper" arrow>
    Verify your wrapper’s I/O locally
  </Card>

  <Card title="Connect" icon="play" href="/snowglobe/docs/connect/connect-to-snowglobe" arrow>
    Connect your chatbot to a simulation
  </Card>
</CardGroup>