Skip to main content

Use your photos to design and try on outfits

Project description

Looking Glass

Use your photos to design and try on outfits — powered by AI image generation.

Supports OpenAI and Google Gemini as image generation providers.

Installation

Requires uv.

uv tool install looking-glass-cli

Quick Start

# 1. Set at least one API key (OpenAI, Gemini, or both)
glass config set openai_api_key sk-your-key-here
glass config set gemini_api_key your-gemini-key-here

# 2. Add a photo of yourself
glass photo add ~/selfie.jpg --name me

# 3. Add outfit descriptions (plain text files)
echo "Elegant navy suit, white dress shirt, silk tie" > formal.txt
glass outfit add formal.txt

echo "Hawaiian shirt, cargo shorts, flip-flops" > beach.txt
glass outfit add beach.txt --name beach-vibes

# 4. Run interactive mode — pick a photo, pick outfits, pick a provider, generate!
glass

Commands

Command Description
glass Interactive mode — select a photo, outfits, and provider, then generate images
glass photo add <file> [--name NAME] Add a photo
glass photo list List stored photos
glass photo remove <name> Remove a photo
glass outfit add <file> [--name NAME] Add an outfit description
glass outfit capture <file> [--name NAME] Capture an outfit description from a photo using OpenAI vision
glass outfit create --name NAME Create an outfit description in your default editor
glass outfit list List stored outfits
glass outfit remove <name> Remove an outfit
glass config set <key> <value> Set a config value
glass config show Show all available config options and their current values

Options

  • --output, -o PATH — Directory for generated images (default: current directory)
  • --version — Show version

Configuration

Run glass config show to see all available options with descriptions and defaults.

Key Description Default
openai_api_key OpenAI API key for image generation
gemini_api_key Google Gemini API key for image generation
max_workers Max parallel image generations 4

At least one API key is required. If both are configured, you'll be prompted to choose a provider during interactive mode.

Note: The glass outfit capture command requires an OpenAI API key to extract outfit descriptions from photos.

Migrating from an older version? The api_key config key has been replaced by openai_api_key. Your existing key will be migrated automatically on first run.

How It Works

  1. Photos and outfit files are stored in ~/.looking-glass/
  2. Outfits are plain .txt files — the filename is the name, the content is the description
  3. In interactive mode, select a photo, one or more outfits, and a provider
  4. For each outfit, the app sends your photo + a prompt to the selected provider's API
  5. Generated images are saved as {photo}_{outfit}.png

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

looking_glass_cli-1.3.0.tar.gz (22.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

looking_glass_cli-1.3.0-py3-none-any.whl (27.6 kB view details)

Uploaded Python 3

File details

Details for the file looking_glass_cli-1.3.0.tar.gz.

File metadata

  • Download URL: looking_glass_cli-1.3.0.tar.gz
  • Upload date:
  • Size: 22.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for looking_glass_cli-1.3.0.tar.gz
Algorithm Hash digest
SHA256 f5425e3613e98e7ecc152700f6d5fe3e2fc13c9a7277d611252429fce3b0c451
MD5 8951e96f198f8c69b30d4be08382f3a8
BLAKE2b-256 2d55c5ef9e617ca2e9d81f0ed135eb0b674b4a329bf8607e13e18074062e0aa9

See more details on using hashes here.

File details

Details for the file looking_glass_cli-1.3.0-py3-none-any.whl.

File metadata

  • Download URL: looking_glass_cli-1.3.0-py3-none-any.whl
  • Upload date:
  • Size: 27.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for looking_glass_cli-1.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b8565d223b24e99bb3c23667ad37c59d1a93fbae6a155b145057e0fc2fdc0bf9
MD5 c15cb50de48be91c8de618973d72ab1e
BLAKE2b-256 c2544012d074aaa26f5d81d64a17d0dbe165f1411a7821079c8c02e1c1e2dfae

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page