SkyPilot 🚁

SkyPilot is a CLI and TUI for OpenAI's Sora 2 video generation API. It helps you launch jobs, monitor progress, download outputs, and automate your release workflow with AI-authored changelog entries.

🌐 Visit the landing page | ❤️ Support via GitHub Sponsors

Disclaimer: SkyPilot is a GUI for OpenAI's video generation API. It is not affiliated with, endorsed by, or sponsored by OpenAI.

Why SkyPilot?

• 🔒 Privacy First: Runs entirely on your machine—your API key never touches our servers (because we don't have any)
• 💰 Cost Transparent: Real-time cost tracking in 150+ currencies before and after generation
• ⚡ Zero Config: npx skypilot and you're ready—no installation needed
• 🌍 Bilingual: Full support for English and Japanese
• 📊 Beautiful TUI: Terminal dashboard with live progress tracking
• 🔓 Open Source: MIT licensed, audit every line of code

Installation

brew tap gunta/skypilot https://github.com/gunta/skypilot
brew install gunta/skypilot/skypilot
# or install from npm
npm install -g skypilot
# or use npx for one-off runs
npx skypilot --help

Make sure OPENAI_API_KEY is exported in your environment before running the CLI or TUI.

CLI

skypilot --help

Common workflows:

• List jobs (newest first):

  skypilot list --limit 10

• Create a job with full control, watch progress, and download when complete:

  skypilot create \
    --prompt "A koi fish swimming through neon skyscrapers" \
    --model sora-2-pro \
    --seconds 8 \
    --size 1792x1024 \
    --input-reference ./reference.png \
    --watch \
    --download

• Retrieve a single job as JSON:

  skypilot retrieve <video-id> --json

• Download an existing job:

  skypilot download <video-id> --output ./videos/<video-id>.mp4

• Delete a video from OpenAI storage:

  skypilot delete <video-id>

• Change the interface language (English or Japanese):

  skypilot language ja

  Run skypilot language with no arguments to see the current setting (stored in ~/.skypilot/settings.db), or pass next to cycle through supported locales. When unset, SkyPilot autodetects your locale on first run.
• Set your preferred currency for cost estimates (defaults to USD):

  skypilot currency EUR

  The command validates the 1-day cached exchange rates provided by https://open.er-api.com/ and persists your preference in ~/.skypilot/settings.db. When no preference is stored, SkyPilot attempts to autodetect your locale, region, and currency (CLI, browser, or server environments) and seeds the database with the detected currency.

Every CLI listing now includes the estimated and actual (when available) cost for each video in both USD and your preferred currency.

Ink TUI Dashboard

Launch the Ink interface to keep tabs on active jobs:

skypilot tui

Controls:

• ↑/↓ or j/k — change selection.
• c — create a video (enter prompt, press enter, esc to cancel).
• enter — download the selected job to the current directory.
• d — delete the selected job (press y to confirm, n or esc to cancel).
• r — refresh immediately (automatic refresh runs in the background).
• m — cycle the Sora model.
• t — cycle available durations (4s, 8s, 12s).
• s — cycle output resolutions.
• l — switch between available interface languages.
• q or esc — quit the dashboard.

The dashboard displays a banner reminding users that SkyPilot is a GUI for OpenAI's video generation API. It renders the job list in a sortable table, shows a status distribution chart, and surfaces estimated/actual costs in your preferred currency—localized to whichever language you select.

Development

bun install
npm run build
npm run typecheck

The source TypeScript remains in src/ and is compiled to dist/ for publishing.

Automated Releases

SkyPilot ships with AI-assisted release tooling:

• npm run generate:changelog — produces a Markdown changelog entry for the next release by feeding recent commits into GPT‑5 via the OpenAI SDK.
• npm run update:homebrew — refreshes the Homebrew formula under Formula/skypilot.rb using the latest published package tarball.
• npm run release -- --type patch — bumps the version (or use --version 1.2.3), regenerates the changelog, builds the package, commits, tags, and optionally publishes if you add --publish.

Example end-to-end release:

npm run release -- --type patch --publish
# then push the commit and tag:
git push && git push --tags

The release script requires a clean working tree and OPENAI_API_KEY to be set so the changelog generator can talk to OpenAI.

Programmatic Usage

import { createVideo, listVideos, calculateVideoCost, getCurrencyFormatter } from 'skypilot';

const video = await createVideo({ prompt: 'A calm lake at sunrise', model: 'sora-2' });
const videos = await listVideos({ limit: 5 });

const cost = calculateVideoCost(video);
if (cost) {
  const formatter = await getCurrencyFormatter();
  console.log('Estimated cost', formatter.format(cost.estimatedUsd));
}

The Ink App and Commander program are also exported:

import { SkyPilotApp, runSkyPilotCli } from 'skypilot';

Locale detection helpers are available too:

import { detectLocale } from 'skypilot';

const info = detectLocale();
console.log(info.locale, info.region, info.currency);

License

MIT