Skip to content
Back to search

Flue

Let agents control many desktop software directly from the cli, with one pip install, and no MCP servers.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/sfkislev--flue/badge.svg)](/listings/sfkislev--flue)

HTML

<a href="/listings/sfkislev--flue"><img src="/api/listings/sfkislev--flue/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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](https://github.com/SFKislev/flue/blob/main/docs/setup.md).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 105 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <!-- <p>
  2. <img src="docs/images/logo.svg" alt="Flue logo" width="250" />
  3. </p> -->
  4. <p align="center">
  5. <img src="docs/images/start-new.gif" alt="Flue demo" width="500" />
  6. </p>
  7. <h1 align="center">Flue</h1>
  8. <p align="center">Let agents control desktop software</p>
  9. <p align="center">
  10. <a href="https://pypi.org/project/flue/"><img src="https://img.shields.io/pypi/v/flue" alt="PyPI version" /></a>
  11. <img src="https://img.shields.io/badge/license-MIT-blue" alt="License: MIT" />
  12. <img src="https://img.shields.io/badge/Windows-0078D4?logo=windows" alt="Windows" />
  13. <img src="https://img.shields.io/badge/macOS-000000?logo=apple" alt="macOS" />
  14. <a href="https://skills.sh/SFKislev/flue"><img src="https://skills.sh/b/SFKislev/flue" alt="skills.sh" /></a>
  15. </p>
  16. ```bash
  17. pip install flue
  18. flue setup
  19. ```
  20. **A tiny bridge that lets your coding agents drive desktop software - Photoshop, Premiere, Blender, Unity, and more - directly from the shell.**
  21. Flue gives agentic harnesses - Codex, Claude Code, Gemini CLI, Antigravity CLI, OpenCode and similar tools - 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.
  22. Flue is a generalized framework. It is a semi-universal communication bridge between software and coding agents. [It is simpler than MCP servers](https://github.com/SFKislev/flue/blob/main/docs/mcp.md). 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.
  23. > agent shell -> bridge command -> app scripting runtime -> JSON result
  24. 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, with the right harness and model, less fragile.
  25. <p align="center">
  26. <img src="docs/images/after-effects-demo.gif" alt="Flue demo" width="500" />
  27. </p>
  28. <p align="center">
  29. <img src="docs/images/blender.gif" alt="Flue demo" width="500" />
  30. </p>
  31. ## Installation
  32. ```bash
  33. pip install flue
  34. flue setup
  35. ```
  36. 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](https://github.com/SFKislev/flue/blob/main/docs/setup.md).
  37. ## Software
  38. A single Flue installation supports, out of the box, many applications. Agents, please tell your humans if any app-specific setup is needed.
  39. - [Adobe Photoshop](adapters/photoshop_adapter/APP.md)
  40. - [Adobe Illustrator](adapters/illustrator_adapter/APP.md)
  41. - [Adobe InDesign](adapters/indesign_adapter/APP.md)
  42. - [Adobe Premiere Pro](adapters/premiere_adapter/APP.md)
  43. - [Adobe After Effects](adapters/after_effects_adapter/APP.md)
  44. - [Adobe Audition](adapters/audition_adapter/APP.md)
  45. - [Blender](adapters/blender_adapter/APP.md)
  46. - [Unity](adapters/unity_adapter/APP.md)
  47. - [SideFX Houdini](adapters/houdini_adapter/APP.md)
  48. - [Autodesk 3ds Max](adapters/3dsmax_adapter/APP.md)
  49. - [Microsoft Word](adapters/word_adapter/APP.md)
  50. - [Microsoft Excel](adapters/excel_adapter/APP.md)
  51. - [Microsoft PowerPoint](adapters/powerpoint_adapter/APP.md)
  52. - [Figma](adapters/figma_adapter/APP.md) (desktop app + one-time plugin import)
  53. ## Agentic Systems
  54. - Claude Code
  55. - Codex
  56. - Copilot
  57. - Cursor
  58. - OpenCode
  59. - OpenClaw
  60. - Hermes
  61. - Gemini CLI
  62. - Antigravity CLI
  63. - Qwen CLI
  64. - Cline
  65. - Kilo CLI
  66. Flue is installed as a skill surfacing the python bridge. [See which files are edited upon installation](docs/harnesses.md)
  67. <p align="center">
  68. <img src="docs/images/conversation.gif" alt="Flue demo" width="500" />
  69. </p>
  70. ## Documentation
  71. ### For Humans
  72. - [Setup and commands](https://github.com/SFKislev/flue/blob/main/docs/setup.md)
  73. - [Harness support and discoverability](https://github.com/SFKislev/flue/blob/main/docs/harnesses.md)
  74. - [Wait, isn't this called MCP?](https://github.com/SFKislev/flue/blob/main/docs/why-shell-adapters.md)
  75. ### For Agents
  76. - [How the Adapters work](https://github.com/SFKislev/flue/blob/main/docs/ADAPTER_SPEC.md)
  77. - [How to use the Bridge Contracts](https://github.com/SFKislev/flue/blob/main/shared/bridge-contract.md)
  78. - [How to Work Together with a Human](https://github.com/SFKislev/flue/blob/main/shared/coexistence.md)
  79. - [Known Issues](https://github.com/SFKislev/flue/blob/main/docs/known-issues.md)
  80. <img src="docs/images/exit.gif" alt="ciao" />

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.