Image Studio

Kirill VechkasovFile Viewers & Editors10
Get it for macOS

Keep generated project photos in a gallery and create or edit the next image from the panel or chat. People profiles use labeled reference sheets and can build missing face, body, and detail views for reuse across models. Nano Banana 2, 2.1, Pro, and Muse Image use paid fal.ai or kie.ai API keys; Muse Image requires fal.ai. The chat Send form remembers the model, frame, and size, with 2K as the default size; the interface supports English and Russian, and 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 a labeled reference sheet (face angles, body views, close-ups); each generation sends only the slots the prompt needs, and Build sheet generates the missing ones. 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, Nano Banana 2.1 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.60CLI 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), in new chats and handoffs on local or enrolled remote machines. Requires BB 0.43.0 or later on macOS or Linux and an installed, authenticated supported CLI; provider subscription limits or API charges apply.9Env 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.73File GatewayBrowse files across your BB machines and FTP/SFTP sites, then add the right file to a chat. Preview folders and media, download individual files or a folder’s visible files as a ZIP, and insert native file mentions 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 and hidden-file controls.29

More in File Viewers & Editors 38

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, and several files or a whole folder download as one zip. 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.Foma635
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 Telb488