Metadata-Version: 2.3
Name: sovai
Version: 0.2.38
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
Classifier: Programming Language :: Python :: 3.13
Provides-Extra: full
Requires-Dist: boto3 (>=1.20)
Requires-Dist: dash (>=2.0) ; extra == "full"
Requires-Dist: dash-bootstrap-components (>=1.6.0) ; extra == "full"
Requires-Dist: edgar-tool (>=1.3.3,<2.0.0)
Requires-Dist: great-tables (>=0.9) ; extra == "full"
Requires-Dist: ipywidgets (>=8.1.3) ; extra == "full"
Requires-Dist: joblib (>=1.0)
Requires-Dist: lightgbm (>=4.5.0) ; extra == "full"
Requires-Dist: matplotlib (>=3.0) ; extra == "full"
Requires-Dist: mfles (>=0.2) ; extra == "full"
Requires-Dist: networkx (>=3.3,<4.0)
Requires-Dist: numba (>=0.50) ; extra == "full"
Requires-Dist: numpy (>=1.20)
Requires-Dist: openai (>=1.0) ; extra == "full"
Requires-Dist: pandas (>=1.0)
Requires-Dist: pexpect (>=4.9.0) ; extra == "full"
Requires-Dist: plotly (>=5.0) ; extra == "full"
Requires-Dist: polars (>=1.2,<2.0)
Requires-Dist: polars-talib (==0.1.3) ; extra == "full"
Requires-Dist: pyarrow (>=5.0)
Requires-Dist: python-dateutil (>=2.8)
Requires-Dist: python-dotenv (>=0.10)
Requires-Dist: pyvis (>=0.3.2,<0.4.0)
Requires-Dist: rapidfuzz (>=3.9.7,<4.0.0)
Requires-Dist: requests (>=2.20)
Requires-Dist: ruptures (>=1.0) ; extra == "full"
Requires-Dist: s3fs (>=2024.10.0,<2025.0.0)
Requires-Dist: scikit-learn (>=1.0) ; extra == "full"
Requires-Dist: scipy (>=1.0) ; extra == "full"
Requires-Dist: seaborn (>=0.13.2,<0.14.0)
Requires-Dist: shap (>=0.40) ; extra == "full"
Requires-Dist: skfolio (>=0.3) ; extra == "full"
Requires-Dist: statsforecast (>=1.0) ; extra == "full"
Requires-Dist: tensorly (>=0.6) ; extra == "full"
Requires-Dist: yachalk (>=0.1.6,<0.2.0)
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
)
```

