Metadata-Version: 2.1
Name: sovai
Version: 0.1.16
Summary: python for asset management
License: Proprietary License
Author: Derek Snow
Author-email: d.snow@outlook.com
Requires-Python: >=3.10,<4.0
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: boto3 (>=1.20)
Requires-Dist: dash (>=2.0)
Requires-Dist: great-tables (>=0.9)
Requires-Dist: joblib (>=1.0)
Requires-Dist: matplotlib (>=3.0)
Requires-Dist: mfles (>=0.2)
Requires-Dist: numba (>=0.50)
Requires-Dist: numpy (>=1.20)
Requires-Dist: openai (>=1.0)
Requires-Dist: pandas (>=1.0)
Requires-Dist: plotly (>=5.0)
Requires-Dist: polars (>=0.20.30)
Requires-Dist: pyarrow (>=5.0)
Requires-Dist: python-dateutil (>=2.8)
Requires-Dist: python-dotenv (>=0.10)
Requires-Dist: requests (>=2.20)
Requires-Dist: ruptures (>=1.0)
Requires-Dist: scikit-learn (>=1.0)
Requires-Dist: scipy (>=1.0)
Requires-Dist: shap (>=0.40)
Requires-Dist: skfolio (>=0.3,<0.4)
Requires-Dist: statsforecast (>=1.0)
Requires-Dist: tensorly (>=0.6)
Description-Content-Type: text/markdown

[![Sovai Python SDK package](https://github.com/sovai-research/SovAI/actions/workflows/main.yml/badge.svg)](https://github.com/sovai-research/SovAI/actions/workflows/main.yml) 
[![Publish Sovai SDK to TestPyPI](https://github.com/sovai-research/SovAI/actions/workflows/python-package.yml/badge.svg)](https://github.com/sovai-research/SovAI/actions/workflows/python-package.yml)

# SovAI SDK Tool Kit Package

Python SDK Tool Kit, which provides some functions that help you fast receive information from Cloud API.

## Quick start

### Prerequisites:

- Python 3.8+

### Create the main app with authorization

```python
import sovai as sv

# There are three ways how to login to the API

# 1. Configuration API connection
sv.ApiConfig.token = "super_secret_token"
sv.ApiConfig.base_url = "https://google.com"

# 2. Read token from .env file e.g API_TOKEN=super_secret_token
sv.read_key('.env')

# 3. The Basic authentication method
sv.basic_auth("test@test.com", "super_strong_password")

# And then continue working with get some data from API and manipulating them
```

### Retrieve data from different endpoints from the API server

```python
# Retrieve data
gs_df = sv.get("bankruptcy/monthly", params={"version": 20221013})
```

### Retrieve charts data with plotting graphs

```python
# Retrieve data with plotting special flag `plot=True`
data_pca = sv.get(
    endpoint="bankruptcy/charts", params={"tickers": "A", "chart": "pca"}, plot=True
)
```

