whatisgithub

What is agnes-free-model-skills?

kangarooking/agnes-free-model-skills — explained in plain English

Analysis updated 2026-05-18

41PythonAudience · developerComplexity · 2/5LicenseSetup · easy

In one sentence

A set of AI agent skills that let Codex or similar tools call Agnes AI's free text, image, and video generation models.

Mindmap

mindmap
  root((Agnes Free Skills))
    What it does
      Text generation skill
      Image generation skill
      Video generation skill
    Tech stack
      Python
      Codex agent skills
      Agnes AI API
    Use cases
      Add free AI generation to an agent
      Generate images from prompts
      Create short videos asynchronously
    Audience
      Vibe coders
      Agent builders
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Give an AI coding agent the ability to generate free text responses via Agnes.

USE CASE 2

Generate or transform images from a text prompt through the image skill.

USE CASE 3

Create short videos asynchronously and poll until they are ready to download.

USE CASE 4

Add these skills to a Codex or compatible agent's skills directory for reuse.

What is it built with?

PythonCodex SkillsAgnes AI API

How does it compare?

kangarooking/agnes-free-model-skillsaimer-zero/redforge-aiarthuryangx/nano-notebooklm
Stars414141
LanguagePythonPythonPython
Setup difficultyeasymoderatemoderate
Complexity2/54/52/5
Audiencedeveloperdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires an Agnes API key set as an environment variable, no key is bundled with the repository.

MIT license: free to use, modify, and distribute, including for commercial purposes, as long as the copyright notice is kept.

So what is it?

This repository is a set of three agent skills that plug into Codex or similar AI agent tools, letting them call Agnes AI's free text, image, and video generation models. It only contains the reusable skill files, reference documentation, and small Python helper scripts. It does not include any API keys, generated content, or output files from running the scripts. The three skills cover different jobs. The text skill calls Agnes's free flash text model and supports normal chat responses, streaming output, and experimental tool calling. The image skill calls Agnes's free image model to generate a picture from a text description, or to transform an existing image, and downloads the result. The video skill calls Agnes's free video model, which works asynchronously: you start a video generation task, then poll it until it finishes and download the finished clip. To install a skill, you copy its folder into your Codex skills directory, or you can keep the whole repository anywhere and point your own agent runtime at the relevant SKILL.md file. Before using any of the scripts, you need an Agnes API key, which you provide through an environment variable rather than writing it into any file. The helper scripts also accept an alternate environment variable name, and you can override the API's base address if it ever changes. Each script can be run directly from the command line, for example asking the text model to explain something in three sentences, generating an illustration from a prompt, or creating a short vertical video clip. The project is explicit about its security boundaries: keys are read only from environment variables, no real keys or generated media are checked into the repository, and common output folders are excluded through gitignore. It is released under the MIT license.

Copy-paste prompts

Prompt 1
Help me copy the agnes-free-text skill into my Codex skills directory.
Prompt 2
Show me how to set the AGNES_API_KEY environment variable safely.
Prompt 3
Walk me through generating an image with agnes_image.py from a prompt.
Prompt 4
Explain how to poll and download a video once agnes_video.py creates a task.
Prompt 5
Help me verify the scripts compile correctly with python3 -m py_compile.

Frequently asked questions

What is agnes-free-model-skills?

A set of AI agent skills that let Codex or similar tools call Agnes AI's free text, image, and video generation models.

What language is agnes-free-model-skills written in?

Mainly Python. The stack also includes Python, Codex Skills, Agnes AI API.

What license does agnes-free-model-skills use?

MIT license: free to use, modify, and distribute, including for commercial purposes, as long as the copyright notice is kept.

How hard is agnes-free-model-skills to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is agnes-free-model-skills for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.