[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [fal Grain](https://spiral.ai/integrations/gemini-cli/fal-grain)

# How to Use fal Grain in Gemini CLI

fal Grain adds film grain to an existing image for photographic finishing. Use it to compare texture treatments while adjusting intensity and scale.

|  |  |
| --- | --- |
| Model | fal Grain |
| Available through | fal |
| Category | Image |
| Price | $0.0013 per image. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with fal Grain in Gemini CLI

- Use fal Grain on the homepage photo in this project with modern style and intensity 0.2; show it beside the original.
- Use fal Grain on our editorial cover image with analog style at three intensities, keeping scale fixed for comparison.
- Use fal Grain to compare kodak and fuji styles on the portfolio portrait, holding intensity and scale constant.
- Use fal Grain on the music page artwork with cinematic style; keep the page title as separate HTML text.
- Use fal Grain on the project’s poster image with newspaper style, then preview it in the existing poster layout.

## How to set up fal Grain in Gemini CLI

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the server**: Or add it to `~/.gemini/settings.json` yourself:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
gemini mcp list
```

### Use the Spiral skill

1. **Send Gemini CLI this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run fal Grain**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "fal-ai/post-processing/grain",
    "input": {
      "image_url": "https://storage.googleapis.com/falserverless/web-examples/post-process/postpro-input.jpg"
    }
  }'
```

Then paste one of the prompts above: Gemini CLI finds fal Grain on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini-cli

## fal Grain tools and prices

- [Post Processing Grain](https://spiral.ai/tools/fal/fal-ai/post-processing/grain) (fal): $0.0013 per image.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| grain_intensity | 0 to 1 | 0.4 | Film grain intensity |
| grain_scale | 1 to 100 | 10 | Film grain scale |
| grain_style | modern, analog, kodak, fuji, cinematic, newspaper | modern | Style of film grain to apply |

## What can you do with fal Grain in Gemini CLI?

Create grain-treated photography for a website or app using fal Grain. Have the coding agent compare treatments in the project's layout before choosing an asset.

### Portrait finishing

Try a restrained grain treatment on a finished portrait, then compare the face and background with the original.

### Travel photo essays

Apply a chosen grain treatment across selected travel photos, reviewing each image before assembling the essay.

### Music cover artwork

Test pronounced grain on existing cover artwork. Add the title separately after selecting the image treatment.

### Fashion editorial selects

Compare grain styles on a representative fashion photograph before treating the remaining selects.

### Website photography

Prepare grain-treated alternatives for existing website photos and compare them in the actual page layout.

### Film poster concepts

Apply grain to an existing poster image, then review it with the typography placed above the treated artwork.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Gemini CLI guides](https://spiral.ai/integrations/gemini-cli)

## fal Grain in other agents

- [Amp](https://spiral.ai/integrations/amp/fal-grain)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/fal-grain)
- [Claude](https://spiral.ai/integrations/claude-desktop/fal-grain)
- [Claude Code](https://spiral.ai/integrations/claude-code/fal-grain)
- [Cline](https://spiral.ai/integrations/cline/fal-grain)
- [Codex](https://spiral.ai/integrations/codex/fal-grain)
- [Cursor](https://spiral.ai/integrations/cursor/fal-grain)
- [Devin](https://spiral.ai/integrations/devin/fal-grain)
- [dots](https://spiral.ai/integrations/dots/fal-grain)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/fal-grain)
- [Gemini](https://spiral.ai/integrations/gemini/fal-grain)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/fal-grain)
- [goose](https://spiral.ai/integrations/goose/fal-grain)
- [Grok](https://spiral.ai/integrations/grok/fal-grain)
- [Grok Build](https://spiral.ai/integrations/grok-build/fal-grain)
- [Hermes](https://spiral.ai/integrations/hermes/fal-grain)
- [Instinct](https://spiral.ai/integrations/instinct/fal-grain)
- [Manus](https://spiral.ai/integrations/manus/fal-grain)
- [Muse](https://spiral.ai/integrations/muse/fal-grain)
- [Muse Code](https://spiral.ai/integrations/muse-code/fal-grain)
- [n8n](https://spiral.ai/integrations/n8n/fal-grain)
- [Notion](https://spiral.ai/integrations/notion/fal-grain)
- [OpenClaw](https://spiral.ai/integrations/openclaw/fal-grain)
- [opencode](https://spiral.ai/integrations/opencode/fal-grain)
- [Perplexity](https://spiral.ai/integrations/perplexity/fal-grain)
- [Raycast](https://spiral.ai/integrations/raycast/fal-grain)
- [VS Code](https://spiral.ai/integrations/vscode/fal-grain)
- [Windsurf](https://spiral.ai/integrations/windsurf/fal-grain)
- [Zapier](https://spiral.ai/integrations/zapier/fal-grain)

## More Gemini CLI guides

- [fal Expression Change](https://spiral.ai/integrations/gemini-cli/fal-expression-change)
- [fal Hair Change](https://spiral.ai/integrations/gemini-cli/fal-hair-change)
- [fal Desaturate](https://spiral.ai/integrations/gemini-cli/fal-desaturate)
- [fal Object Removal](https://spiral.ai/integrations/gemini-cli/fal-object-removal)
- [fal Blur](https://spiral.ai/integrations/gemini-cli/fal-blur)
- [fal Retouch](https://spiral.ai/integrations/gemini-cli/fal-retouch)

## Questions about fal Grain in Gemini CLI

**Can Gemini CLI use fal Grain?**

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run fal Grain like any built-in tool.

**How much does fal Grain cost in Gemini CLI?**

$0.0013 per image. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini CLI plan is separate.

**Do I need a fal account to use fal Grain in Gemini CLI?**

No. Spiral runs fal Grain on its own fal account. You sign in to Spiral once and never paste a key.

**How long does it take to set up fal Grain in Gemini CLI?**

About two minutes: add the server, then sign in, then check it.

**Does Gemini CLI wait while fal Grain runs?**

fal Grain runs in the background. Gemini CLI starts the run, checks on it and gives you the image when it's ready.

**What is fal Grain useful for?**

It adds film grain to existing images. Try it when a portrait, editorial photo, or cover image needs a deliberate texture treatment.

**How should I describe the result I want?**

Give the agent a concrete editing brief: identify the image, request a light or pronounced treatment, and ask for comparisons. For example, request three intensity levels with style and scale held constant.

**How should I tune the grain?**

Compare styles first while keeping intensity and scale fixed. Then adjust one setting at a time so you can judge what changed.

**How can I check whether the grain looks right?**

Review the result at several zoom levels, including its intended display size. Keep the original beside it and inspect faces, smooth backgrounds, and fine details.

**When should I keep a clean version?**

Keep a clean comparison when small lettering, product labels, or fine detail matters. Choose the grain treatment only after checking those areas at the intended viewing size.

