nova-canvas

# Nova Canvas Generate images via Amazon Nova Canvas on AWS Bedrock. ## AWS Auth Methods | Method | How to Use | |--------|------------| | **Bearer token** | `AWS_BEARER_TOKEN_BEDROCK` env var or `--bearer-token` | | **Environment variables** | Set `AWS_ACCESS_KEY_ID` + `AWS_SECRET_ACCESS_KEY` | | **Credentials file** | Configure `~/.aws/credentials` | | **Named profile** | `--profile my-profile` or `AWS_PROFILE` env var | | **Direct keys** | `--access-key AKIA... --secret-key ...` | | **Temporary credentials** | Add `--session-token` with direct keys | | **IAM instance role** | Auto-detected on EC2/ECS/Lambda | | **AWS SSO** | Run `aws sso login` first | Auto-detection order: direct keys → profile → bearer token → env vars → credentials file → instance role → SSO. ## Quick Start ```bash python3 {baseDir}/scripts/generate.py "your prompt" -o output.png python3 {baseDir}/scripts/generate.py "your prompt" -o output.png --profile work python3 {baseDir}/scripts/generate.py "your prompt" -o output.png --access-key AKIA... --secret-key ... ``` ## Parameters | Flag | Default | Description | |------|---------|-------------| | `prompt` | — | Text description of the image | | `-o, --output` | output.png | Output file path | | `-W, --width` | 1024 | Width 512-4096, divisible by 64 | | `-H, --height` | 1024 | Height 512-4096, divisible by 64 | | `-n, --count` | 1 | Number of images (1-5) | | `-q, --quality` | standard | `standard` or `premium` | | `-s, --seed` | random | Seed for reproducibility | | `--negative` | — | Negative prompt (what to avoid) | | `--cfg` | 8.0 | CFG scale 1.1-10.0 | | `--region` | us-east-1 | AWS region | | `--profile` | — | AWS named profile | | `--access-key` | — | AWS Access Key ID | | `--secret-key` | — | AWS Secret Access Key | | `--session-token` | — | AWS Session Token | | `--bearer-token` | — | Bearer token (overrides env) | ## Workflow 1. Craft a detailed English prompt (Nova Canvas performs best in English). 2. Choose size: square 1024×1024, landscape 1280×768, portrait 768×1280. 3. Run `generate.py` with `timeout=120`. 4. Send resulting image to user via `message` tool. ## Prompt Tips - Detailed English prompts yield best results. - Specify style: "oil painting", "watercolor", "3D render", "photograph", "anime". - Use `--negative "blurry, low quality, text, watermark"` to exclude unwanted elements.