Bring your Photoshop edits to life using Nano Banana and Flux Kontext! 🍌 🍌

🎉 Now with Reference image support! 🎉

Supports MacOS and Windows

✨SeeDream 4 4k edits are coming in the next few hours!

✨ Update 09/Sept: We added a new CCX/UXP panel version of the plugin. It will have feature parity in the next 24h. Installation walkthrough video and Usage demo. If you have an error installing - please contact plugins@astria.ai

✨ Update 07/Sept: The Photoshop Nano Banana and Flux Kontext script, originally created by Rob de Winter, is now part of Astria. Alon Burg and his team will continue development and are working on a powerful new plugin that will on the Astria platform and should launch within this week. In the meantime, you can keep using this version as usual, and once the new plugin is ready you will be able to switch over seamlessly. Exciting things ahead! ✨

This script makes photo editing and compositing in Photoshop feel even more intuitive. Use the tools you already know such as selections, brushes and colors, and then let Nano Banana (Gemini 2.5 Flash) or Flux Kontext bring your ideas to life. With simple, user friendly prompts you can create edits that look natural and are super fun to explore.

• Nano Banana (Gemini 2.5 Flash): fast generation with extras like Use Foreground Color and Reference Image (now available on both Windows and macOS 🎉).
• Flux Kontext (Pro & Max): context-aware edits, typography, lighting.

Your selection is sent to Replicate’s models and the result is placed back as a new layer, keeping lighting, shadows, and materials consistent. You can find the manual and a video with some examples below. Because the AI models run on Replicate, you'll need to create a free account there and add a minimum of $10 credit to access the AI models. With $10 you can generate about 250 images.

Manual

Quick summary

Before diving into the manual, here’s the short version:

1. Make sure to download the latest CCX version of the plugin (and not the JSX plugin)
2. Double click the file to install using Creative Cloud
3. Create an account with Astria and receive an API key and free credits
4. Copy your Astria API token into the plugin panel window.
5. Start generating inside Photoshop.

Not too bad, right? Below you’ll find the full step-by-step manual.

Here is a video walkthrough of the installation of the CCX plugin.

Plugin usage demo video

For any questions - please contact plugins@astria.ai

1. Install the plugin

1.1 Click to install

Double click the newly downloaded CCX file in your Finder/File Explorer to install it in Adobe Creative Cloud

Plugin installation prompt in Adobe Creative Cloud

Plugin installed. Click "Open Photoshop"

After downloading the CCX file from Gumroad product page, double click the CCX file to install it in Creative Cloud.

2. Launch Photoshop with the new panel

2.1 Start plugin

Launch Photoshop with the new plugin and click "Open Astria"

2.2. Login to Astria

Click the "Open Astria" button in Step 1 and click "Sign in with Google"

Sign-in to Astria

Navigate to the API tab and click "Generate" to create a new API key

2.3. Create API key

Navigate to Astria API tab and click "Generate" to create a new API key.

Once you create a new API key - you will receive some free credits from Astria.

Copy the API key to your clipboard and paste it in the Photoshop plugin panel

2.4 Add API key to plugin

4. Start editing

You are ready to start making your first edits! Select an area, write a prompt describing what you would like changed (e.g: "Add a cat") and click "Submit".

A new layer will be added with the new changes.

Tips

• Keep prompts short and specific. Mention material, color, lighting. Prompts in Flux Kontext need to be more specific than Nano Banana.
• Make selections slightly larger or softer to give the models more context.
• Try both Flux Kontext Pro and Max: Pro is great for most cases, Max can be stronger on typography. My preferred method is Nano Banana nowadays, except for changing the environmental lighting, and blending objects.
• Try drawing a sketch, and then let Nano Banana make something out of it. I had very impressive results.
• Use Upscale if the generated area feels too small or soft.

Troubleshooting

1. Error "Network request failed" - Your Windows firewall or Antivirus is blocking the request. Adjust your firewall/Antivirus to allow the requests to Astria API.
2. CCX not associated with Creative install / Cannot install plugin - Try enabling "Developer mode" in the setting, Unzip the CCX file, and copy it to C:\Users\<UserName>\AppData\Roaming\Adobe\UXP\Plugins\External\NanoBanana\
3. Error when trying to install CCX plugin: "The document "...ccx" could not be opened. Creative Cloud cannot open files of this type" - on MacOS try opening the Terminal app - and run
   ./UnifiedPluginInstallerAgent --install ~/Downloads/ee0f4287_PS.ccx
4. For any further issues - please contact plugins@astria.ai