Metadata-Version: 2.4
Name: annapurna
Version: 0.0.8
Summary: Python SDK for Annapurna Suite
Author-email: Annapurna Suite <sebastian.avalos@annapurnasuite.com>
License-File: LICENSE
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 (like Jupyter and VS Code) directly with Annapurna's AWS-backed 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 (Pandas/PyArrow) and Annapurna's 3D Viewer to rapidly test and deploy custom estimation 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