Metadata-Version: 2.4
Name: alaas-cli
Version: 0.1.4
Summary: Command-line client for the ALaaS API - upload images and get back the most useful ones to label.
Project-URL: Homepage, https://alaas2.com
Project-URL: Documentation, https://alaas2.com/docs
Author-email: David Pogorzelski <support@dpogoda.dev>
License: MIT
Keywords: active-learning,cli,computer-vision,labeling,machine-learning
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.11
Requires-Dist: click>=8.1
Requires-Dist: httpx>=0.27
Requires-Dist: rich>=13.9
Description-Content-Type: text/markdown

# alaas-cli

Command-line client for [ALaaS](https://alaas2.com) - Active Learning as a
Service. Send your images to the API, then ask which ones are the most useful
to label next. Train better models with a fraction of the labelling budget.

## Install

```bash
pip install alaas-cli
```

## Quickstart

Create an account and an API key at [alaas2.com](https://alaas2.com)
(new accounts get 10,000 free credits), then:

```bash
export ALAAS_API_KEY=alaas_live_...

# 1. Create a pool
alaas pools create my-dataset

# 2. Upload your images (they are processed right away and never stored)
alaas upload ./images --pool <pool_id>

# 3. Get the most useful images to label next
alaas select --pool <pool_id> -k 50

# 4. Label them, then repeat - already selected images never come back
alaas select --pool <pool_id> -k 50
```

Check your credits balance any time:

```bash
alaas usage
```

## Configuration

Either environment variables or `~/.alaas/config.toml`:

```toml
api_key = "alaas_live_..."
# api_url = "https://api.alaas2.com"   # default
```

All commands support `--json` for machine-readable output.

## Links

- Website: https://alaas2.com
- API reference: https://alaas2.com/docs
- Agent-readable docs: https://api.alaas2.com/llms.txt
