{"_id":"@0xtiby/fal-cli","_rev":"3-6aba561b66a44251870be1a3249fbffe","name":"@0xtiby/fal-cli","dist-tags":{"latest":"1.0.1"},"versions":{"0.0.0-placeholder":{"name":"@0xtiby/fal-cli","version":"0.0.0-placeholder","_id":"@0xtiby/fal-cli@0.0.0-placeholder","maintainers":[{"name":"0xtiby","email":"rekt2591@gmail.com"}],"dist":{"shasum":"25f934f339573f6346b2f387d751d89a689f5164","tarball":"https://registry.npmjs.org/@0xtiby/fal-cli/-/fal-cli-0.0.0-placeholder.tgz","fileCount":86,"integrity":"sha512-v/5Y/ggMkCYDmaWPyVcc3r9kx4pqroaq7ybNjaXGVkai9b5ywZxT2D6D1/JM5NYseIKaMAOzAXDpsjrGTSw/AA==","signatures":[{"sig":"MEYCIQDaOn1z6CqFgmWXWa/mn0LKw0LSxS+9zrtvc/VsmTgbXgIhAJuHCYwmIyi3omC9Xa+vJipdlVXransljjOsUF43Jneb","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":520943},"gitHead":"b399496b4503030cd3cfdcda43242e33a13b6b21","_npmUser":{"name":"0xtiby","email":"rekt2591@gmail.com"},"_npmVersion":"10.8.2","description":"CLI tool for generating and editing images via the fal.ai API","directories":{},"_nodeVersion":"20.18.3","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/fal-cli_0.0.0-placeholder_1773860934084_0.2689994521730694","host":"s3://npm-registry-packages-npm-production"}},"1.0.0":{"name":"@0xtiby/fal-cli","version":"1.0.0","keywords":[],"author":{"name":"0xtiby","email":"https://github.com/0xtiby"},"license":"MIT","_id":"@0xtiby/fal-cli@1.0.0","maintainers":[{"name":"0xtiby","email":"rekt2591@gmail.com"}],"homepage":"https://github.com/0xtiby/fal-cli#readme","bugs":{"url":"https://github.com/0xtiby/fal-cli/issues"},"bin":{"fal-cli":"src/index.js"},"dist":{"shasum":"b68fd082528daf7f9b5ab4c6d3103f94899e059e","tarball":"https://registry.npmjs.org/@0xtiby/fal-cli/-/fal-cli-1.0.0.tgz","fileCount":23,"integrity":"sha512-3Te6WxIrPC0CC/Jbb+0JiBqHmisfbjSFrONcQVqu+EgOPCJAZmXzE6d7MOP4AG7xjT+7CEH7vrHYCkt/v7qBHQ==","signatures":[{"sig":"MEQCIAeephna8oJ2E2PNYaWujqVdQLX0sMdDsVj/nCjr+FxxAiAvx1MqAuEjeskyXWNowH45V7ET/IO5q4unLa/ANRd9cw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@0xtiby%2ffal-cli@1.0.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":136989},"main":"src/index.js","type":"module","gitHead":"b3b703a388712a9c673621f7090914e225f32bb7","scripts":{"lint":"echo 'No lint configured yet'","test":"node --test src/**/*.test.js","build":"echo 'No build step required'","bootstrap":"./scripts/bootstrap.sh","setup:branch-protection":"./scripts/setup-branch-protection.sh"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:d1cca959-5726-4151-b493-178b34cc22c3"}},"repository":{"url":"git+https://github.com/0xtiby/fal-cli.git","type":"git"},"_npmVersion":"11.12.0","description":"CLI tool for generating and editing images via the fal.ai API","directories":{},"_nodeVersion":"22.22.1","dependencies":{"ora":"^9.3.0","incur":"^0.3.4","dotenv":"^17.3.1","@fal-ai/client":"^1.9.4","@inquirer/prompts":"^8.3.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@9.11.0","devDependencies":{"semantic-release":"^25.0.2","@semantic-release/github":"^12.0.2"},"_npmOperationalInternal":{"tmp":"tmp/fal-cli_1.0.0_1773870270096_0.6641704563406599","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@0xtiby/fal-cli","version":"1.0.1","type":"module","packageManager":"pnpm@9.11.0","description":"CLI tool for generating and editing images via the fal.ai API","bin":{"fal-cli":"src/index.js"},"main":"src/index.js","scripts":{"build":"echo 'No build step required'","lint":"echo 'No lint configured yet'","test":"node --test src/**/*.test.js","bootstrap":"./scripts/bootstrap.sh","setup:branch-protection":"./scripts/setup-branch-protection.sh"},"repository":{"type":"git","url":"git+https://github.com/0xtiby/fal-cli.git"},"keywords":[],"author":{"name":"0xtiby","email":"https://github.com/0xtiby"},"license":"MIT","bugs":{"url":"https://github.com/0xtiby/fal-cli/issues"},"homepage":"https://github.com/0xtiby/fal-cli#readme","publishConfig":{"access":"public"},"dependencies":{"@fal-ai/client":"^1.9.4","@inquirer/prompts":"^8.3.2","dotenv":"^17.3.1","incur":"^0.3.4","ora":"^9.3.0"},"devDependencies":{"@semantic-release/github":"^12.0.2","semantic-release":"^25.0.2"},"gitHead":"8df5f97f6f20ea6515a32dce172d5e7007f2e251","_id":"@0xtiby/fal-cli@1.0.1","_nodeVersion":"22.22.1","_npmVersion":"11.12.0","dist":{"integrity":"sha512-91csqnfW1PVAXMCNqenlH1gQCU/QXPd63KQC1PGj6KO4r69akKkR1PvG7XNfM4y1Dc4OzT0W+LGLJQzo++tGGw==","shasum":"d73c0f13b9e46b4ca2452d4c479db2e74e4e7f38","tarball":"https://registry.npmjs.org/@0xtiby/fal-cli/-/fal-cli-1.0.1.tgz","fileCount":23,"unpackedSize":137987,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@0xtiby%2ffal-cli@1.0.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIELeWRmy9SLGevjpgu0NN9JsrrWjGepHV+esx8iz7T2YAiBi6HYcEjVUCSxyLnAR+7HPontqhGIwfV9S593AIXd30A=="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:d1cca959-5726-4151-b493-178b34cc22c3"}},"directories":{},"maintainers":[{"name":"0xtiby","email":"rekt2591@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/fal-cli_1.0.1_1773906475171_0.560007577338091"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-18T19:08:53.969Z","modified":"2026-03-19T07:47:55.589Z","0.0.0-placeholder":"2026-03-18T19:08:54.250Z","1.0.0":"2026-03-18T21:44:30.268Z","1.0.1":"2026-03-19T07:47:55.312Z"},"bugs":{"url":"https://github.com/0xtiby/fal-cli/issues"},"author":{"name":"0xtiby","email":"https://github.com/0xtiby"},"license":"MIT","homepage":"https://github.com/0xtiby/fal-cli#readme","keywords":[],"repository":{"type":"git","url":"git+https://github.com/0xtiby/fal-cli.git"},"description":"CLI tool for generating and editing images via the fal.ai API","maintainers":[{"name":"0xtiby","email":"rekt2591@gmail.com"}],"readme":"# fal-cli\n\nCLI tool for generating and editing images via the [fal.ai](https://fal.ai) API.\n\n## Install\n\n```bash\nnpm install -g @0xtiby/fal-cli\n```\n\n## Setup\n\nSet your fal.ai API key:\n\n```bash\nexport FAL_KEY=your-api-key\n```\n\nOr add it to `~/.fal-cli/.env` for persistent configuration (see [Configuration](#configuration) below).\n\n## Configuration\n\nfal-cli loads configuration from multiple sources in the following precedence order:\n\n1. **CLI flags** (highest priority)\n2. **Shell environment variables** (`export FAL_KEY=...`)\n3. **Config file** (`~/.fal-cli/.env`)\n4. **Built-in defaults** (lowest priority)\n\n### Config file\n\nCreate `~/.fal-cli/.env` to set persistent defaults:\n\n```env\nFAL_KEY=your-api-key-here\nFAL_DEFAULT_MODEL=fal-ai/flux/schnell\nFAL_OUTPUT_DIR=./generated\nFAL_IMAGE_SIZE=landscape_4_3\nFAL_VERBOSE=false\n```\n\n### Environment variables\n\n| Variable | Default | Description |\n|---|---|---|\n| `FAL_KEY` | *(required)* | fal.ai API key |\n| `FAL_DEFAULT_MODEL` | `fal-ai/flux/schnell` | Default model endpoint |\n| `FAL_OUTPUT_DIR` | `./generated` | Output directory for generated files |\n| `FAL_IMAGE_SIZE` | `landscape_4_3` | Default image size preset |\n| `FAL_VERBOSE` | `false` | Show full request/response |\n\n## Usage\n\n### Generate media from a prompt\n\n```bash\nfal-cli generate --model fal-ai/flux/schnell --prompt \"a cat in space\"\n```\n\nOptions:\n\n| Flag | Description |\n|------|-------------|\n| `--model` | Model endpoint ID (e.g. `fal-ai/flux/schnell`) |\n| `--prompt` | Text prompt for generation |\n| `--image` | Reference image: path, URL, data URI, or `-` for stdin |\n| `--size` | Image size preset (`square_hd`, `landscape_16_9`, etc.) |\n| `--output` | Output directory |\n| `--seed` | Seed for reproducible generation |\n| `--verbose` | Show full request/response |\n\n### Interactive mode\n\nGuided wizard for model selection and image generation:\n\n```bash\nfal-cli interactive\n```\n\n### Browse models\n\n```bash\nfal-cli models              # List all models\nfal-cli models categories   # List model categories\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}