Files
client/README.md
gilesb 864cada65e feat: Art DAG CLI client
- artdag.py CLI for L1 server interaction
- run: start rendering jobs
- runs: list all runs
- status: check run status
- cache/view: manage cached content (pipe to mpv with -o -)
- assets: list known assets
- import: add files to cache

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 11:04:49 +00:00

99 lines
1.5 KiB
Markdown

# Art DAG Client
CLI for interacting with the Art DAG L1 rendering server.
## Setup
```bash
pip install -r requirements.txt
```
## Usage
```bash
# Set server URL (default: http://localhost:8100)
export ARTDAG_SERVER=http://localhost:8100
# Or pass with every command
./artdag.py --server http://localhost:8100 <command>
```
## Commands
### Server Info
```bash
./artdag.py info
```
### List Known Assets
```bash
./artdag.py assets
```
### Start a Rendering Run
```bash
# Using asset name
./artdag.py run dog cat
# Using content hash
./artdag.py run dog 33268b6e167deaf018cc538de12dbe562612b33e89a749391cef855b320a269b
# Wait for completion
./artdag.py run dog cat --wait
# Custom output name
./artdag.py run dog cat --name my-dog-video
```
### List Runs
```bash
./artdag.py runs
./artdag.py runs --limit 20
```
### Check Run Status
```bash
./artdag.py status <run-id>
```
### List Cached Content
```bash
./artdag.py cache
```
### View/Download Cached Content
```bash
# Show info
./artdag.py view <content-hash>
# Download to file
./artdag.py view <content-hash> -o output.mkv
# Pipe to mpv (use -o - for stdout)
./artdag.py view <content-hash> -o - | mpv -
```
### Import Local File to Cache
```bash
./artdag.py import /path/to/file.jpg
```
## Example Workflow
```bash
# Check server
./artdag.py info
# See available assets
./artdag.py assets
# Run dog effect on cat, wait for result
./artdag.py run dog cat --wait
# List completed runs
./artdag.py runs
# Download the output
./artdag.py view <output-hash> -o result.mkv
```