> ## Documentation Index
> Fetch the complete documentation index at: https://docs.praison.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Image Description

> Analyze and describe images using vision-capable AI models

The `--image` flag enables vision-based image analysis and description using models like GPT-4o.

## Quick Start

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai "Describe this image" --image photo.png
```

## Usage

### Basic Image Description

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai "What's in this image?" --image /path/to/image.jpg
```

**Expected Output:**

```
This image shows a scenic mountain landscape with snow-capped peaks 
reflecting in a crystal-clear lake. The foreground features pine trees 
and wildflowers, creating a classic alpine scene.
```

### Detailed Analysis

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai "Analyze this image in detail, including colors, composition, and mood" --image photo.png
```

### Multiple Images

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai "Compare these two images" --image image1.png,image2.png
```

### With Custom Model

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai "Describe this image" --image photo.png --llm gpt-4o
```

## Supported Formats

* PNG (`.png`)
* JPEG (`.jpg`, `.jpeg`)
* GIF (`.gif`)
* WebP (`.webp`)
* BMP (`.bmp`)
* SVG (`.svg`)
* TIFF (`.tiff`)

## Use Cases

### Content Analysis

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai "What products are shown in this image?" --image product-photo.jpg
```

### Accessibility

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai "Generate alt text for this image" --image website-banner.png
```

### Document Analysis

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai "Extract text from this screenshot" --image screenshot.png
```

### Code Review

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai "What does this diagram show?" --image architecture-diagram.png
```

## Combine with Other Features

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# With guardrail
praisonai "Describe this image" --image photo.png --guardrail "Keep description under 100 words"

# With metrics
praisonai "Analyze this chart" --image chart.png --metrics

# With save
praisonai "Describe this image" --image photo.png --save
```

## Default Model

The default vision model is `gpt-4o` which provides excellent image understanding capabilities. You can override this with `--llm`:

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai "Describe this" --image photo.png --llm gpt-4o-mini
```

<Note>
  Image description uses vision-capable models to **analyze existing images**.
  To **generate new images** from text, use `--image-generate` instead.
</Note>