> ## 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 the `snowglobe sdk` for python is, when to use it, and the end-to-end flow to get your chatbot connected to Snowglobe.

The Snowglobe SDK for Python allows fine grained, programmatic control of your Agents and Simulations.

## When to use the Snowglobe SDK

Use this flow when you want to:

* Programmatically interact with individual endpoints of the Snowglobe API
* Programmatically perform individual CRUD operations on your Agents and Simulations in your Python code.

DO NOT use this flow (and instead use the `snowglobe` cli package) when you want to:

* Connect an existing chatbot to Snowglobe for processing synthetic conversations from a Simulation
* Perform complex workflows with minimal or guided input

## Prerequisites

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

## Installation

Install the Python package:

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