datalab-cli 0.1.0

A powerful CLI for converting, extracting, and processing documents using the Datalab API
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135

# Commands Overview

The Datalab CLI provides commands for document processing, file management, and workflow automation.

---

## Document Processing

| Command | Description |
|---------|-------------|
| [`convert`](convert.md) | Convert documents to markdown, HTML, JSON, or chunks |
| [`extract`](extract.md) | Extract structured data using a JSON schema |
| [`segment`](segment.md) | Split multi-document PDFs into logical sections |
| [`fill`](fill.md) | Fill PDF or image forms with field data |
| [`track-changes`](track-changes.md) | Extract track changes from Word documents |
| [`create-document`](create-document.md) | Generate DOCX from markdown |
| [`extract-score`](extract-score.md) | Score extraction results with confidence ratings |

---

## File Management

| Command | Description |
|---------|-------------|
| [`files upload`](files.md#upload) | Upload a file to Datalab storage |
| [`files list`](files.md#list) | List uploaded files |
| [`files get`](files.md#get) | Get file metadata |
| [`files download`](files.md#download) | Download a file |
| [`files delete`](files.md#delete) | Delete a file |

---

## Workflow Management

| Command | Description |
|---------|-------------|
| [`workflows create`](workflows.md#create) | Create a new workflow |
| [`workflows list`](workflows.md#list) | List all workflows |
| [`workflows get`](workflows.md#get) | Get workflow details |
| [`workflows execute`](workflows.md#execute) | Execute a workflow |
| [`workflows execution`](workflows.md#execution) | Get execution status |
| [`workflows delete`](workflows.md#delete) | Delete a workflow |
| [`workflows step-types`](workflows.md#step-types) | List available step types |

---

## Cache Management

| Command | Description |
|---------|-------------|
| [`cache stats`](cache.md#stats) | Show cache statistics |
| [`cache clear`](cache.md#clear) | Clear cached responses |

---

## Global Options

These options are available on all commands:

| Option | Short | Description |
|--------|-------|-------------|
| `--quiet` | `-q` | Suppress all progress output |
| `--verbose` | `-v` | Enable verbose progress output (even when piped) |
| `--help` | `-h` | Print help information |
| `--version` | `-V` | Print version information |

---

## Common Patterns

### Output Redirection

All commands output JSON to stdout:

```bash
# Pipe to jq for processing
datalab convert document.pdf | jq '.content'

# Save to file
datalab convert document.pdf > result.json

# Use --output flag
datalab convert document.pdf --output result.json
```

### Error Handling

Errors are output to stderr. Exit codes:

- `0` - Success
- `1` - Error

```bash
# Check exit code in scripts
if datalab convert document.pdf; then
    echo "Success"
else
    echo "Failed"
fi
```

### Progress Suppression

For scripts, suppress progress output:

```bash
datalab -q convert document.pdf
```

### Cache Control

```bash
# Skip local cache
datalab convert document.pdf --skip-cache

# Force reprocessing (skip API cache)
datalab convert document.pdf --force
```

---

## Getting Help

```bash
# General help
datalab --help

# Command-specific help
datalab convert --help
datalab extract --help

# Man pages (if installed)
man datalab
man datalab-convert
```