mcpField
A
agnes-free-image

agnes-free-image

github.com/kangarookingCreative & media200131 installsUpdated 21w ago
Repository

About agnes-free-image

A skill for generating and transforming images with the agnes-image-2.1-flash model through Agnes API. It guides prompt preparation and provides a Python helper for requests, dry runs, and saving returned image URLs.

Key features

  1. 01Text-to-image generation
  2. 02Image-to-image transformation from public URLs
  3. 03Prompt structuring guidance
  4. 04Request validation with dry-run
  5. 05Save returned images locally

Use cases

  1. 01Creating images from written scene descriptions
  2. 02Restyling a reference image while retaining composition
  3. 03Checking request parameters before an API call
  4. 04Saving generated image results to a local directory

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/kangarooking/agnes-free-model-skills --skill agnes-free-image

After installing, type/agnes-free-imagein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

agents/
openai.yaml
references/
api.md
scripts/
agnes_image.py

Details

From the project README

Agnes Free Image

Use this skill to generate or transform images with agnes-image-2.1-flash.

Credential Rule

Read the API key from the environment. Do not hardcode keys in prompts, scripts, skill files, commits, or shell history.

Preferred variable:

export AGNES_API_KEY="..."

The helper also accepts AGNES_TOKEN as a fallback.

Quick Start

Text-to-image:

python3 scripts/agnes_image.py generate \
  --prompt "A luminous floating city above a misty canyon at sunrise, cinematic realism" \
  --size 1024x768 \
  --output-dir ./outputs/agnes-free-image

Image-to-image with a public image URL:

python3 scripts/agnes_image.py generate \
  --prompt "Transform the scene into a rain-soaked cyberpunk night while preserving the composition" \
  --image-url "https://example.com/input.png" \
  --size 1024x768 \
  --output-dir ./outputs/agnes-free-image

Validate the request shape without calling the API:

python3 scripts/agnes_image.py generate \
  --prompt "A detailed AI workflow dashboard poster, clean editorial style" \
  --size 1024x1024 \
  --dry-run

Prompt Pattern

Use this structure for text-to-image:

[Subject] + [Scene / Environment] + [Style] + [Lighting] + [Composition] + [Quality Requirements]

For image-to-image, say both what should change and what should remain unchanged.

Workflow

  1. Decide whether the request is text-to-image or image-to-image.
  2. Turn vague visual requests into a concrete prompt with subject, environment, style, lighting, composition, and detail level.
  3. Use scripts/agnes_image.py generate. Prefer --dry-run first for complex prompts or reference images.
  4. Save returned image URLs locally with --output-dir when the response includes downloadable URLs.
  5. Read references/api.md when the raw response shape or advanced parameters matter.

Notes

  • Endpoint: POST https://apihub.agnes-ai.com/v1/images/generations
  • Model: agnes-image-2.1-flash
  • Default size in the helper is 1024x768.
  • For image-to-image, input images must be URL-accessible and are sent under extra_body.image.
  • The helper asks for URL responses with extra_body.response_format: "url".

Reference

Read references/api.md when you need request fields, response handling, or prompt examples from the source docs.

Comments

Markdown supported