CLI

tellers-ai/tellers-cli

Open-source CLI to interact with Tellers from the terminal: search, edit, and generate videos. Built with Rust; API client is generated from our OpenAPI spec.

Build from source

Clone the repo and build with Cargo:

# Generate the client crate from OpenAPI
scripts/generate_api.sh

# Build the CLI
cargo build --release

Requires Rust and, for client generation, openapi-generator (brew install openapi-generator).

Authentication

Use an API key from Tellers. Create one in the app: go to app.tellers.ai → user menu → API keys → Create new. Then set it for the CLI: 

export TELLERS_API_KEY=sk_...

Optional — override API base URL:

export TELLERS_API_BASE=https://api.tellers.ai

All actions you run via the CLI (or API) using this token will spend your account credits based on the requests. Make sure you have credits on app.tellers.ai before calling the API; new users who sign in with Google SSO get a few free credits to start.

Usage

Chat

  • tellers "prompt" — minimal chat TUI with streamed response
  • tellers --full-auto --background "prompt" — start a chat and print only the chat id

Upload

Upload media files to Tellers:

tellers upload /path/to/media_folder

Common flags:

  • --disable-description-generation — Disable automatic time-based media descriptions (enabled by default)
  • --dry-run — Analyze files without uploading
  • --force-upload — Upload even if already uploaded
  • --local-encoding — Enable local encoding before upload
  • --parallel-uploads <n> — Parallel uploads (default: 4)
  • --ext <ext> — Filter by extension (e.g. --ext mp4 --ext mov)
  • --in-app-path <path> — In-app path for uploaded files

Files ≥ 10 MiB use multipart S3 upload (presigned part URLs, then complete); smaller files use a single presigned PUT.

API reference

For full endpoint details, see the API reference.