# Freepik AI CLI

A sophisticated, beautiful Python CLI for generating and manipulating images and video with the [Freepik API](https://docs.freepik.com/introduction).

## Installation

```bash
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
```

## Quick Start

```bash
export FREEPIK_API_KEY=your_api_key_here

# Generate an image
freepik generate-image "a majestic mountain at sunset" --model flux-2-pro

# Generate a video from an image
freepik generate-video photo.jpg --prompt "gentle ocean waves" --model kling-o1-pro

# Upscale an image
freepik upscale-image photo.jpg --mode precision-v2 --scale 4x

# Upscale a video
freepik upscale-video clip.mp4 --mode standard
```

## Commands

| Command | Description |
|---------|-------------|
| `generate-image` | Generate images from text prompts |
| `generate-video` | Animate an image into a video |
| `generate-icon` | Generate icons in various styles |
| `upscale-image` | Upscale and enhance images |
| `upscale-video` | Upscale video to higher resolution |
| `expand-image` | Outpaint / expand image borders |
| `relight` | Relight an image (Premium) |
| `style-transfer` | Apply artistic styles (Premium) |
| `describe-image` | Reverse-engineer an image into a prompt |
| `config` | Manage CLI configuration |

## Configuration

```bash
freepik config show
freepik config set default_image_model mystic
freepik config set default_output_dir ~/images
```