122d8a89d0
- Publish command now requires login and sends auth token - Added Authentication section to README with login/register docs - Uses L2 server for authentication when publishing runs 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
139 lines
2.3 KiB
Markdown
139 lines
2.3 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>
|
|
```
|
|
|
|
## Authentication
|
|
|
|
The client authenticates against an L2 server for commands that require login (e.g., `run`, `publish`).
|
|
|
|
```bash
|
|
# Set L2 server URL (default: http://localhost:8200)
|
|
export ARTDAG_L2=https://artdag.rose-ash.com
|
|
|
|
# Or pass with every command
|
|
./artdag.py --l2 https://artdag.rose-ash.com <command>
|
|
```
|
|
|
|
### Login
|
|
```bash
|
|
./artdag.py login <username>
|
|
# You'll be prompted for your password
|
|
|
|
# Or specify password with -p flag (will prompt)
|
|
./artdag.py login <username> -p
|
|
```
|
|
|
|
### Register
|
|
```bash
|
|
./artdag.py register <username>
|
|
# You'll be prompted to enter and confirm your password
|
|
|
|
# Optionally include email
|
|
./artdag.py register <username> --email user@example.com
|
|
```
|
|
|
|
### Check Current User
|
|
```bash
|
|
./artdag.py whoami
|
|
```
|
|
|
|
### Logout
|
|
```bash
|
|
./artdag.py logout
|
|
```
|
|
|
|
## 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
|
|
```
|