What is agnes-ai?

Agnes-AI is a command line tool that lets you use the Agnes AI service, which can generate text, describe images, generate images, and generate videos, all from a single Python script. It has no external library dependencies, meaning it runs using only what already comes with Python, so there is nothing extra to install with pip. To use it, you clone the repository and set an API key from Agnes AI's own website, which you get by signing up for an account there. Once your key is set, you run commands like agnes text to generate written responses, agnes image to create pictures from a text description or transform an existing image, and agnes video to generate short video clips from a text prompt, a starting image, or a pair of start and end frames. Several convenience features are built in. If you write a prompt in a language other than English, the tool automatically translates it to English before sending it to the model, though this can be turned off. A dry run mode lets you preview exactly what would be sent to the API without actually spending any credits, which is useful for checking your command before running it for real. For video generation, the tool automatically checks in on the job's progress and can download the finished video once it is ready, instead of requiring you to poll manually. The tool also includes a small local web page you can run to try out the features in a browser, and a file meant to help AI coding assistants understand how to use the tool as part of their own workflows. Image and video commands let you set details like output size, frame count, and frame rate, and local image files passed as references are automatically uploaded to a public file host so the API can reach them. Overall this project is a thin, dependency free wrapper around the Agnes AI API, aimed at people who want to script AI generation tasks from the command line without building their own API client.