Get it for macOS

Keep generated photos for the current project in a gallery, then make the next one from the panel or from chat. People profiles store selfies and body details so a named person stays recognizable. Nano Banana 2, Nano Banana Pro, and Muse Image run through fal.ai or kie.ai; those providers bill generation, and Muse Image is fal.ai only. The chat Send form remembers the last model, frame, and size. English and Russian UI; Env Catalog can hold the keys.


Overview

View source

What you get

A gallery of photos generated for the current BB project, in their real aspect ratios. People profiles with reference selfies so a named person stays recognizable. A generate form in the plugin panel, and in chat a Send form with model, frame, and size already filled from last time.

How it works

Open Image Studio in BB's sidebar. The gallery is the home screen: WebP thumbnails, click to preview, prompt plus generate at the bottom. Profiles hold body details and up to three selfies plus an optional manicure photo used when hands are in frame. Settings turn models on and off through a searchable list, pick English or Russian, and store API keys (a typed key wins over Env Catalog).

Nano Banana 2 and Nano Banana Pro default to kie.ai; fal.ai remains available with --gateway fal. Size defaults to 2K. Muse Image runs on fal.ai only. GPT Image 2.5 (Flare/Sunburst), FLUX.2 Pro, Seedream 5.0 Pro, and Grok Imagine are opt-in in settings and run on both gateways. Generated files stay with the project; profiles are shared across projects.

In a thread, ask for a photo. The agent fills the prompt from the bundled skill template for that model, then calls image_studio_generate (not the CLI) so you can change model, aspect ratio, and size, then press Send.

Requirements

BB 0.43 or later. A paid fal.ai and/or kie.ai API key. Muse Image needs fal.ai. The Env Catalog plugin is optional for storing those keys. Generation is billed by those providers, not by this plugin.

More from Kirill Vechkasov

Agent ToolsShow which MCP servers and skills each BB machine actually has, then bring them to one catalogue and one canon. A matrix marks present, missing, and drifted configs; new servers wait for adopt, keep-local, or hide. Sync adds what is missing and never deletes on its own. The Skills tab treats ~/.agents/skills as a git canon, with fan-out into CLI homes and a version archive. Writes back up each config first; loopback paths and local secrets stay on that machine. Optional MetaMCP listing needs that gateway's API key.NewCLI AgentsStart each chat with a specialist agent or selected profile instructions. Choose native Claude Code and OpenCode agents, or Codex profile developer instructions (up to 4096 characters; other profile settings are not applied), on local or enrolled remote machines. Requires BB 0.43.x on macOS or Linux and an installed, authenticated supported CLI; provider subscription limits or API charges apply.2Env CatalogStore API keys, tokens, and secrets in a single encrypted catalog across all BB sessions and machines. Securely request credentials via masked in-app modals. Agents automatically check available credentials before prompting you, and persist newly provided keys on demand. Values are encrypted at rest with AES-256-GCM and synchronized via your central BB server. Includes dedicated agent tools, a full-featured management UI with .env import/export, and terminal CLI commands.18File GatewayBrowse files across your BB machines and FTP/SFTP website accounts, then add a native file mention to a chat so the agent opens the correct source and path. Read text or download files without exposing account passwords to agents. Requires connected BB machines or reachable website accounts; macOS/Linux, read-only website access, 256 MiB between BB hosts and 32 MiB from websites. English interface with drag-to-chat mentions, hidden-file controls and native file preview.8

More in File Viewers & Editors 13

Browse, open, preview, or edit files and document vaults.

View all
File ManagerManage the files on the machine bb runs on without a terminal: browse, upload, move, rename, extract and hand them to the agent. Opens as a sidebar page, as a tab beside a thread that can start in that thread's folder, and from a file link in a message. Double-click shows images, PDF, video, Markdown and code; Space looks inside zip, tar, 7z and rar archives without extracting them. Multi-gigabyte uploads resume after a dropped connection. On a phone, selected rows get an Actions bar with the whole row menu. Access stays inside the home folder of the user bb runs as; tar, 7z and rar archives need tar and 7z on that machine.Foma375
FilesA VS Code-style file explorer and editor for the workspace behind a thread. Search in files finds a word across every file in the project: results are grouped by file with each hit highlighted, and clicking one opens the file on that line. It is smart case, with match-case, whole-word and regex toggles, and built for typing — file contents stay in memory between searches, so refining a query re-runs in tens of milliseconds, and a regex runs in its own worker so a runaway pattern cannot freeze BB. Around it: a file tree that shows dotfiles, editor tabs, a go-to-file palette (Cmd+P), find in the open file (Cmd+F), syntax highlighting in your BB code theme, and edit and save guarded so a change an agent made underneath you is never clobbered. Markdown files open rendered, with the source and the editor one click away. Two pickers choose the project and then its checkout or one of its worktrees; beside a thread it is pinned to that thread's worktree. Adds a `bb files` command so agents can browse and read the same workspace from the CLI, on whichever machine it lives.AbdElrahman Telb256