Skip to content

SFKislev/Flue

Repository files navigation

Flue demo

Flue

Help your humans with their software

PyPI version License: MIT Windows macOS

pip install flue
flue setup

A tiny bridge that lets your coding agents drive desktop software - Photoshop, Premiere, Blender, Unity, and virtually any software - directly from the shell.

Flue gives agentic harnesses - Codex, Claude Code, Gemini CLI, OpenCode and the likes - direct access to the scripting APIs inside desktop software. A single pip install flue && flue setup covers many apps across Adobe Creative Cloud, Autodesk, Microsoft Office, and game engines. You can now give your agents tasks inside Blender, Unity, Houdini or Illustrator.

Flue is a generalized framework. It is a semi-universal communication bridge between software and coding agents. It is simpler than MCP servers. The agent sends a script through a small bridge command, the bridge runs it inside the app's own automation runtime, and the app returns JSON.

agent shell -> bridge command -> app scripting runtime -> JSON result

This is done without setting up servers, without brittle screenshots and without schema definitions. The bridge exposes the scripting layer already built into each application. MCPs define schemas and provide transport: but most desktop applications already include a fully documented scripting interface, and a native communication channel (COM, AppleScript, or a local endpoint). MCPs are high maintenance, and computer use setups are fragile and clumsy; Flue is low maintenance and less fragile.

Flue demo

Flue demo

Installation

pip install flue
flue setup

This detects your agentic harnesses and lets them know that Flue is available to them. Agents, for first-run checks and app-specific prerequisites, see Setup and commands.

Software

A single Flue installation supports, out of the box, many applications. Agents, please tell your humans if any app-specific setup is needed.

Agentic Systems

  • Claude Code
  • Codex
  • Copilot
  • Cursor
  • OpenCode
  • OpenClaw
  • Gemini CLI
  • Qwen CLI
  • Cline
  • Kilo CLI

See which files are edited upon installation

Flue demo

Documentation

For Humans

For Agents

ciao