# Project Overview

## Overview
This project shows the basic setup of an AI automated system.

## Folders
- **docs**: The instruction manual for the project
- **specs**: Specification files defining features to implement. Contains a `completed/` subfolder for finished specs.

## Tools

### image_tools.py
Image generation utilities using PIL.

**Functions:**
- `create_image_with_text` - Creates a white image with centered text
- `superimpose_text_on_image` - Adds centered text overlay to an existing image
- `create_image_with_random_shapes` - Creates an image with random rectangles and ellipses

**Terminal usage:**
```bash
# Create image with text
python tools/image_tools.py create_text <file_name> <text> <width> <height>

# Superimpose text on existing image
python tools/image_tools.py superimpose <file_name> <text>

# Create image with random shapes
python tools/image_tools.py shapes <file_name> <width> <height>
```

### video_tools.py
Video generation utilities using ffmpeg.

**Functions:**
- `generate_moving_text_video` - Creates a video with text scrolling horizontally across the center
- `create_slideshow_from_images` - Creates a slideshow video from a list of images

**Terminal usage:**
```bash
# Generate video with scrolling text
python tools/video_tools.py moving_text <file_name> <text>

# Create slideshow from images
python tools/video_tools.py slideshow <output_file> <image1> <image2> ... --seconds <duration>
```

### ai_image_tools.py
AI image generation and editing using fal.ai's nano-banana model.

**Functions:**
- `create_ai_image` - Generates an image from a text prompt
- `edit_ai_image` - Edits an existing image using a text prompt

**Terminal usage:**
```bash
# Generate AI image from prompt
python tools/ai_image_tools.py create "<prompt>" --aspect-ratio 16:9 --output <file>

# Edit existing image with AI
python tools/ai_image_tools.py edit <input_file> "<prompt>" --aspect-ratio 16:9 --output <file>
```