Metadata-Version: 2.4
Name: rgba
Version: 0.3.5
Summary: Command-line interface for RGBA — drive the RGBA video-creation API from your terminal or Claude Code.
Author: RGBA
License-Expression: MIT
Project-URL: Homepage, https://rgba.ai
Project-URL: Documentation, https://rgba.ai/docs
Project-URL: Issues, https://rgba.ai/support
Keywords: rgba,ai,video,cli,claude,agent
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
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
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer<1.0,>=0.12
Requires-Dist: httpx<1.0,>=0.27
Dynamic: license-file

# rgba CLI

Thin HTTPS client for the deployed RGBA API (Modal-hosted). The CLI defaults
to the right backend URL; override with `RGBA_API_URL` for local dev.

## Install

```bash
pip install rgba             # from PyPI
pipx install rgba            # isolated user install (recommended for daily use)
```

After install you'll have a `rgba` command on your PATH.

## Usage

```bash
rgba auth login              # device-flow → opens https://rgba.ai/cli in your browser
rgba auth status             # show whoami
rgba auth logout             # revoke the active token

rgba me                      # alias for `auth status`
rgba actions                 # discover every /sdk/action with cost + params
rgba actions <name>          # full schema for one action
rgba sdk <action> -p key=val # call /sdk/action
rgba jobs get <job_id>       # poll a job
rgba jobs wait <job_id>      # poll until status is completed/failed
rgba actions social-publish -p operation=channels # connected social accounts
rgba actions social-publish --params-file publish.json # draft/post/schedule video
```

Credentials live in `~/.rgba/credentials` (mode 0600). The CLI never sees
your Supabase password — auth is brokered through a device-flow OAuth
against the RGBA backend.

## Publish videos

Video publishing supports YouTube, Instagram, and TikTok through Postiz.
In RGBA, open **Settings → Connect Postiz**, save your Postiz workspace API
key, and connect your social accounts. Multiple channels are supported.
The key stays on the server; do not pass it to the CLI.

Run `rgba actions social-publish -p operation=channels` to find channel IDs.
For a YouTube draft, save this as `publish.json` with your channel ID and a
public HTTPS video file URL:

```json
{
  "operation": "publish",
  "request_id": "my-video-001",
  "video_url": "https://your-cdn.example/video.mp4",
  "mode": "draft",
  "targets": [{
    "channel_id": "YOUR_CHANNEL_ID",
    "content": "My video description",
    "settings": {"title": "My video", "type": "private", "selfDeclaredMadeForKids": "no"}
  }]
}
```

Then run `rgba actions social-publish --params-file publish.json`.
Local files can first use `rgba actions upload -p file_path=/path/video.mp4`;
use the returned URL. An owned RGBA video's `video_id` can replace `video_url`.
Publishing defaults to a draft; use `mode=now` or `mode=schedule` with a
timezone-aware `publish_at` for authorized automation. Reuse the same
`request_id` and parameters on retries to avoid duplicate submissions.
An `accepted` receipt means Postiz accepted the submission; use
`operation=posts` with `start_date` and `end_date` to check delivery.
Run `rgba actions social-publish` for the full action schema.

## Environment

| var              | default                                                                  | use                                       |
|------------------|--------------------------------------------------------------------------|-------------------------------------------|
| `RGBA_API_URL`   | `https://lemontree-media-llc--rgba-agent-agent-app.modal.run`            | Override the API origin (e.g. localhost)  |
| `RGBA_CONFIG_DIR`| `~/.rgba`                                                                | Override credentials directory            |
