Metadata-Version: 2.4
Name: decompressed-cli
Version: 0.1.3
Summary: CLI for Decompressed - Git-like version control for vector datasets
Author-email: Decompressed <support@decompressed.io>
License-Expression: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: typer>=0.9.0
Requires-Dist: rich>=13.0.0
Requires-Dist: decompressed-sdk>=0.1.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"

# Decompressed CLI

Git-like version control for vector datasets.

## Installation

```bash
pip install decompressed-cli
```

Or install from source:
```bash
cd sdk/cli
pip install -e .
```

## Quick Start

```bash
# Configure your API key
dcp config set api_key YOUR_API_KEY
dcp config set base_url https://api.decompressed.io

# List your datasets
dcp datasets list

# Get dataset info
dcp datasets info my-dataset

# Version control commands
dcp log my-dataset                    # Show version history
dcp checkout my-dataset --version 3   # Pin to version 3
dcp commit my-dataset -m "Added data" # Create new version
dcp tag my-dataset v3 production      # Tag version as 'production'
dcp diff my-dataset 2 3               # Compare versions

# Data commands
dcp pull my-dataset -o ./data/        # Download dataset
dcp push ./vectors.npy my-dataset     # Upload/append vectors
```

## Commands

### Configuration
- `dcp config set <key> <value>` - Set config value
- `dcp config get <key>` - Get config value
- `dcp config list` - List all config

### Datasets
- `dcp datasets list` - List all datasets
- `dcp datasets info <dataset>` - Show dataset details
- `dcp datasets delete <dataset>` - Delete a dataset

### Versioning
- `dcp log <dataset>` - Show version history
- `dcp checkout <dataset> --version <n>` - Pin to specific version
- `dcp commit <dataset> -m <message>` - Commit pending changes
- `dcp tag <dataset> <version> <name>` - Create named ref
- `dcp diff <dataset> <v1> <v2>` - Compare two versions

### Data
- `dcp pull <dataset> -o <path>` - Download dataset vectors
- `dcp push <file> <dataset>` - Upload/append vectors

## Configuration

Config is stored in `~/.decompressed/config.json`:

```json
{
  "api_key": "dcp_xxx",
  "base_url": "https://api.decompressed.io"
}
```
