Skip to content

Releases: howells/falcon

Falcon v1.0.2

27 Jan 17:38
@howells howells
v1.0.2
6ff02bf

Choose a tag to compare

View all tags
Falcon v1.0.2 Latest
Latest

What's New

  • Inline field editing on confirmation screen — Navigate and edit model, aspect ratio, and resolution directly before generating, instead of restarting the flow
  • Quick presets — One-key presets for common generation configurations
  • Unified Edit screen — Redesigned UI with consolidated editing and magenta branding

Improvements

  • --up flag now accepts an explicit image path
  • Skip image selection when editing from Generate screen
  • Use falcon-* prefix for generated images (added to .gitignore)
  • Fix upscale and background removal API response format

Housekeeping

  • Added linting toolchain (Biome, Husky, Ultracite)
  • Fixed lint-staged ultracite config
  • Redesigned README
Assets 2
Loading

Falcon v1.0.1

19 Jan 15:48
@howells howells
v1.0.1
4183bb2

Choose a tag to compare

View all tags
Falcon v1.0.1

Falcon v1.0.1

Minor release with updated logo and installation docs.

Changes

  • New minimal line-art logo
  • Added Homebrew installation: brew tap howells/tap && brew install falcon
  • Updated package.json with npm metadata

Installation

brew tap howells/tap
brew install falcon

See README for full documentation.

Loading

Falcon v1.0.0

19 Jan 15:38
@howells howells
v1.0.0
f852c11

Choose a tag to compare

View all tags
Falcon v1.0.0

Falcon v1.0.0

CLI for generating images with fal.ai. Supports multiple models, batch generation, upscaling, and background removal.

Installation

curl -fsSL https://raw.githubusercontent.com/howells/falcon/main/install.sh | bash

Or with Bun:

git clone https://github.com/howells/falcon.git
cd falcon && bun install && bun link

What's New

Renamed from Falky to Falcon

  • Config directory: ~/.falcon
  • Local config: .falconrc

Security Hardening

  • Fixed command injection vulnerability in image viewer
  • Atomic file writes prevent data corruption on crash
  • Path validation prevents directory traversal attacks
  • Cryptographically secure IDs and temp file names
  • Restrictive file permissions (0o600)

Improvements

  • Optimized history operations for better performance
  • Better error messages when config files are corrupted
  • Complete CLI help with all options documented

Models

Model Name Pricing
banana Nano Banana Pro $0.15-$0.30/image (default)
gpt GPT Image 1.5 $0.01-$0.20/image
gemini Gemini 2.5 Flash $0.039/image
gemini3 Gemini 3 Pro $0.15-$0.30/image

Quick Start

# Set your API key
export FAL_KEY="your-api-key"

# Generate an image
falcon "a cat on a windowsill at sunset"

# Launch interactive studio
falcon

See README for full documentation.

Loading