Metadata-Version: 2.4
Name: annapurna
Version: 0.0.22
Summary: Python SDK for Annapurna Suite
Author-email: Annapurna Suite <sebastian.avalos@annapurnasuite.com>
License: Proprietary
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Requires-Python: >=3.12
Requires-Dist: pandas>=2.3.1
Requires-Dist: pyarrow>=21.0.0
Requires-Dist: requests>=2.31.0
Description-Content-Type: text/markdown

# Annapurna Suite Python SDK

[![PyPI version](https://badge.fury.io/py/annapurna.svg)](https://badge.fury.io/py/annapurna)
[![Python Versions](https://img.shields.io/pypi/pyversions/annapurna.svg)](https://pypi.org/project/annapurna/)

The official Python SDK designed exclusively to empower the **Annapurna Suite Internal Expert Team**. 

This package provides the programmatic foundation required to build automatic, end-to-end workflows and execute advanced resource modeling pipelines. By bridging local Python environments directly with Annapurna's cloud infrastructure, the SDK eliminates manual I/O bottlenecks and enables seamless integration of custom ML and geostatistical algorithms into the platform.

## Core Capabilities

* **End-to-End Automation:** Script complex, multi-step workflows. Automate data ingestion, cleaning, transformation, and metadata generation without interacting with the web UI.
* **Advanced Resource Modeling Integration:** Effortlessly push and pull massive Block Models and Point Clouds between local memory and Annapurna's cloud infrastructure to rapidly test and deploy custom estimation/simulation models.
* **Zero-Friction Parquet Streaming:** Handle multi-gigabyte datasets efficiently. The SDK automatically converts Pandas DataFrames to highly compressed Parquet binaries in RAM and streams them securely to S3.
* **Programmatic Workspace Management:** Programmatically clone, rename, edit, and delete workspace assets on the fly to support iterative modeling loops.

---

## Installation

Install the package directly from PyPI:

```bash
pip install annapurna