Metadata-Version: 2.4
Name: aluna-cli
Version: 0.1.5
Summary: CLI tool for downloading pathology slide files from Aluna
Project-URL: Homepage, https://alunalabs.ai
Project-URL: Repository, https://github.com/alunalabs/aluna-cli
Project-URL: Documentation, https://docs.alunalabs.ai
Author-email: Aluna Labs <support@alunalabs.ai>
License: MIT
License-File: LICENSE
Keywords: digital-pathology,medical-imaging,pathology,svs,whole-slide-imaging
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Healthcare Industry
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Classifier: Topic :: Scientific/Engineering :: Medical Science Apps.
Requires-Python: >=3.8
Requires-Dist: click>=8.0
Requires-Dist: httpx>=0.24.0
Requires-Dist: rich>=13.0
Requires-Dist: tqdm>=4.65.0
Description-Content-Type: text/markdown

# Aluna CLI

A command-line tool for downloading pathology slide files from the Aluna platform.

**Package name**: `aluna-cli`

## Installation

You can run the CLI directly using `uvx` (no installation required):

```bash
uvx aluna-cli download --cart YOUR_CART_ID
```

Or install it permanently:

```bash
pip install aluna-cli
```

## Usage

### Download SVS files from cart

The recommended way to download files is using a cart ID from the Aluna web interface:

```bash
# Using uvx (recommended)
uvx aluna-cli download --cart YOUR_CART_ID

# If installed (the command is still 'aluna' after installation)
aluna download --cart YOUR_CART_ID
```

To get a cart ID:
1. Visit the Aluna web interface
2. Search for pathology slides
3. Add desired files to your cart
4. Go to the cart page to get your download command with cart ID

### Options

- `--cart`, `-c`: Cart ID from the Aluna web interface
- `--output-dir`, `-o`: Directory to save downloaded files (default: current directory)
- `--parallel`, `-p`: Number of parallel downloads (default: 3)
- `--chunk-size`: Download chunk size in MB (default: 10)
- `--api-url`: Custom API URL (default: https://manaflow-ai--aluna-search-backend-0-serve.modal.run)

### Examples

Download files to a specific directory:

```bash
uvx aluna-cli download --cart YOUR_CART_ID -o ./downloads
```

Download with more parallel connections:

```bash
uvx aluna-cli download --cart YOUR_CART_ID -p 5
```

## Features

- Progress bars for each file download
- Parallel downloads for faster performance
- Automatic retry on failure
- Resume partial downloads
- Checksum verification

## License

MIT License - see LICENSE file for details.