# Installation

## Install

<pre class="language-python"><code class="lang-python"><strong>import sovai as sov
</strong><strong>sov.token_auth(token="add_your_subscriber_token_here")
</strong></code></pre>

### Full package

<pre><code><strong>pip install sovai[full]
</strong></code></pre>

{% hint style="success" %}
**The best way to familiarize yourself with this powerful library is to head straight to the**[ **tutorial section.**](/get-started/tutorials.md)
{% endhint %}

### Data package

If you only want to download data into pandas please use the much lighter package.

```
pip install sovai
```

```python
import sovai as sov
sov.data("query")
```

## Environment

Sovai is tested and supported on the following 64-bit systems:

* Python 3.6 – 3.11
* Python 3.9 for Ubuntu only
* Ubuntu 16.04 or later
* Windows 7 or later

In order to avoid potential conflicts with other packages, it is strongly recommended to use a virtual environment, e.g. [python3 virtualenv](https://docs.python.org/3/tutorial/venv.html).

```sh
# Create a virtual environment
python -m venv yourenvname

# Activate the virtual environment
source yourenvname/bin/activate  # For Unix/Linux
yourenvname\Scripts\activate  # For Windows

# Install sovai
pip install sovai

# Create notebook kernel
python -m ipykernel install --user --name yourenvname --display-name "display-name"
```

## Dependencies

Default dependencies that are installed with `pip install sovai` are [listed here](https://github.com/sovai-research/SovAI/blob/master/pyproject.toml).

#### Select the tab

{% tabs %}
{% tab title="requirements" %}
numpy>=1.20

scipy>=1.0

pandas>=1.0

python-dateutil>=2.8

python-dotenv>=0.10

requests>=2.20

joblib>=1.0

pyarrow>=5.0

matplotlib>=3.0

plotly>=5.0

scikit-learn>=1.0

numba>=0.50

boto3>=1.20

dash>=2.0

great-tables>=0.9

polars>=0.20.30

ruptures>=1.0

shap>=0.40

skfolio>=0.3

statsforecast>=1.0

tensorly>=0.6

openai>=1.0

mfles>=0.2

pexpect>=4.9.0

lightgbm>=4.5.0

ipywidgets>=8.1.3

polars-talib==0.1.3

dash-bootstrap-components>=1.6.0
{% endtab %}

{% tab title="requirements-dev" %}
poetry>=1.0

pytest>=6.0

flake8>=3.9

black>=21.0

isort>=5.0

mypy>=0.900
{% endtab %}
{% endtabs %}

## Docker

Docker uses containers to create virtual environments that isolate a Sovai installation from the rest of the system. Sovai docker comes pre-installed with a Notebook environment that can share resources with its host machine (access directories, use the GPU, connect to the Internet, etc.). The Sovai Docker images are tested for each release.

```bash
docker run -p 8888:8888 sovai/slim
```

For docker image with full version:

```bash
docker run -p 8888:8888 sovai/full
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sov.ai/get-started/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.