tomevault-io Logo Generator
Generate professional logos with transparent backgrounds using the repologogen CLI.
Pre-flight Check (MANDATORY)
Run which repologogen to verify the CLI is installed.
If not found, STOP and inform the user:
- Install with:
pip install repologogenoruv tool install repologogen - An
OPENROUTER_API_KEYenvironment variable (or~/.repologogen/config.yaml) is required - Link: https://github.com/tsilva/repologogen
Do NOT proceed if repologogen is not installed.
Execution
Run from the project root:
repologogen [path] [flags]
Flag Mapping
Map user preferences to CLI flags:
| User Request | Flag | Example |
|---|---|---|
| Custom style | -s |
-s "pixel art" |
| Output path | -o |
-o assets/logo.png |
| Project name override | -n |
-n "My Project" |
| Custom model | -m |
-m "openai/dall-e-3" |
| Config file | -c |
-c custom-config.yaml |
| Skip trimming | --no-trim |
|
| Skip compression | --no-compress |
|
| Preview only | --dry-run |
|
| Template variables | --var |
--var KEY=VALUE (repeatable) |
| Verbose output | -v |
Examples
# Default — auto-detects project, generates logo.png
repologogen
# Custom style
repologogen -s "16-bit pixel art"
# Custom output path with verbose logging
repologogen -o assets/logo.png -v
# Dry run to preview prompt
repologogen --dry-run
# Specific project directory
repologogen /path/to/project -s "minimalist vector"
Configuration
repologogen loads config in priority order:
- Project:
.config.yamlin project root - User:
~/.repologogen/config.yaml - Built-in defaults
See repologogen docs for all config options (style, icon_colors, key_color, trim, compress, etc.).
Post-Generation
After repologogen completes, read the generated image with the Read tool to visually verify the result. If unsatisfactory, re-run with adjusted flags (e.g., different -s style).
Converted and distributed by TomeVault — claim your Tome and manage your conversions.