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

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

# 4b. OR: Batch capture outfit descriptions from a folder of photos
glass outfit capturefolder ~/photos --overwrite

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 AI vision
glass outfit capturefolder [FOLDER] [--overwrite] Batch capture outfit descriptions from all images in a folder (uses filenames as outfit names)
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 and glass outfit capturefolder commands require a vision-capable provider (OpenAI supports this via API key).

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.6.1.tar.gz (17.5 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.6.1-py3-none-any.whl (23.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: looking_glass_cli-1.6.1.tar.gz
  • Upload date:
  • Size: 17.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.3 {"installer":{"name":"uv","version":"0.11.3","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.6.1.tar.gz
Algorithm Hash digest
SHA256 7533ae1e59dd047d8726863291e1d254be6c03e5757744752f1a3af234d6fce3
MD5 439a23c5ad8de2222ca0ee46fb71dd48
BLAKE2b-256 2f4aae6a2314eb1949992d3d276e4aba42d52b86a6efd49a656087d72b9a8230

See more details on using hashes here.

File details

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

File metadata

  • Download URL: looking_glass_cli-1.6.1-py3-none-any.whl
  • Upload date:
  • Size: 23.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.3 {"installer":{"name":"uv","version":"0.11.3","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.6.1-py3-none-any.whl
Algorithm Hash digest
SHA256 ddbae5a4fc4c82b0882f47733b437bfa733703866a55057228cedb2af930323a
MD5 a7078e8db39e5b917eb39c1bfebb3a40
BLAKE2b-256 f0b7a4d70dbf570d1a9c4a85aba3057d1f491649fbcf700cfe3f685d0d80a678

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