inkstudioai

AI tattoo generator for your terminal and your AI agents.

One free design for new accounts, no card needed.

inkstudioai is the official command line tool for Ink Studio AI. Describe a tattoo in words and get a finished design as an image file. It also runs as an MCP server, so Claude, Cursor, Windsurf, and other AI agents can create tattoo designs for you.

• Create tattoo designs from text in styles such as fine line, Japanese, traditional, and realism.
• Search the public gallery of tattoo designs for ideas, with no account.
• Check your plan and credits, and buy a plan from the terminal.
• Zero dependencies. Node.js 18.17 or newer.

Install

Run it once with npx:

npx inkstudioai login

Or install it globally:

npm i -g inkstudioai

The package installs two command names, inkstudioai and the shorter inkstudio. They are the same tool.

Quick start

# 1. Sign in. No account yet? Create one in the browser. New accounts get one free design.
npx inkstudioai login

# 2. Create a design. The image is saved in the current directory.
npx inkstudioai generate "a fox sleeping inside a crescent moon" --style fine-line

# 3. Look for ideas in the public gallery.
npx inkstudioai gallery dragon

Output of generate with the free design of a new account:

✔ Design ready in 21s
  File      a-fox-sleeping-inside-a-crescent-moon.webp
  Image     https://cdn.inkstudioai.com/free-tattoo-designs/6718f0c2.webp
  Style     fine-line, black ink, white background
  Quality   free (0 free designs left)
  Saved to  https://inkstudioai.com/account?view=tattoos&utm_source=cli&utm_medium=referral

  Try it on your skin  https://inkstudioai.com/tools/try-tattoo?design=https%3A%2F%2Fcdn.inkstudioai.com%2F...
  Make a stencil       https://inkstudioai.com/tools/tattoo-to-stencil?utm_source=cli&utm_medium=referral

The try-on link opens the website's tattoo simulator with the new design loaded. Links to website pages carry utm_source=cli, so Ink Studio AI can count visits from the CLI. Image, API, and checkout links have no such parameters.

Commands

Every command has --help, and inkstudioai help <command> shows the same text. Global options:

login

Sign in with your browser. The terminal shows a code and opens a page. Check that the page shows the same code, then approve. The CLI saves an API key on your computer.

New to Ink Studio AI? Create an account on the same page. New accounts get one free tattoo design.

inkstudioai login
inkstudioai login --no-browser          # print the link, do not open a browser
inkstudioai login --key isk_...         # save a key from your account page
echo "$KEY" | inkstudioai login --with-key

In a terminal, --with-key asks you to paste the key and press Enter.

generate (alias: gen)

Create a tattoo design from a text prompt.

inkstudioai generate "a fox in a crescent moon"
inkstudioai gen "koi fish with waves" --style japanese --color
inkstudioai gen "rose and dagger" --skin --open
inkstudioai gen "minimal mountain range" --out designs/
inkstudioai gen "lotus flower" --out lotus.webp
inkstudioai gen "compass rose"

... [View full README on GitHub](https://github.com/ciroartz/inkstudioai-cli#readme)