Command Line Interface

CLI options and usage for Image Matching WebUI

Command Line Interface

The imcui package provides a powerful command-line interface for automation and batch processing.

Basic Usage

imcui [OPTIONS]

Start the web interface with default settings:

imcui

Options

Option	Short	Default	Description
--server-name	-s	0.0.0.0	Server hostname/IP
--server-port	-p	7860	Server port number
--config	-c	Auto-detect	Configuration file path
--example-data-root	-d	Auto-download	Example datasets directory
--verbose	-v	False	Enable verbose output
--version			Show version
--help	-h		Show help

Common Use Cases

Custom Port

imcui -p 8080

Local Host Only

imcui -s 127.0.0.1

Custom Configuration

imcui -c /path/to/config.yaml

Custom Data Directory

imcui -d /path/to/datasets

Combine Options

imcui -s 127.0.0.1 -p 8080 -c my_config.yaml -d /my/data --verbose

Configuration Files

Configuration files use YAML format. Place one of these files in your working directory:

• app.yaml
• config/app.yaml

Example configuration:

defaults:
  setting_threshold: 0.1
  max_keypoints: 2000
  enable_ransac: true
  ransac_method: CV2_USAC_MAGSAC
  setting_geometry: Homography

Troubleshooting

Port Already in Use

imcui -p 8081  # Try different port

Permission Denied

imcui -s 127.0.0.1  # Use local host

Configuration Not Found

imcui -c /absolute/path/to/config.yaml

Help and Version

# Display help
imcui --help

# Show version
imcui --version