Skip to content

đŸ–ŧī¸âœ¨ Media Node: Supercharge Your ChainForge Workflows with Images!

Welcome to Media Node! 🚀 A powerful addition to ChainForge's visual programming environment. This guide will show you how to use Media Node to add images đŸ–ŧī¸, boost your LLM evaluation, and prompt engineering workflows — still no coding required! 😎


🤔 What is the Media Node?

Media Node lets you:

  • 📤 Upload and manage images in ChainForge
  • đŸ‘ī¸â€đŸ—¨ī¸ Add visual context to prompts for multimodal LLMs (a.k.a. Vision-Language Models)
  • 🤝 Share visual prompts with your team

đŸ› ī¸ How to Use Media Node in ChainForge

1ī¸âƒŖâž• Add the Media Node to Your Flow

  • Click the top-left Add Node ➕ button
  • Select đŸ“ē Media Node from the Input Data section

Create a Media Node


2ī¸âƒŖđŸ–ŧī¸ Add Images to Your Media Node

đŸ—‚ī¸ Option 1: Upload local Image Files đŸ–ŧī¸ from your computer đŸ’ģ

  • Click the ➕ Add button of the Media Node
  • Click on the Drag & Drop button to select local files
    • You can Drag & Drop files
    • Or you can select one or several files via the pop-up

Upload Local files to the Media Node

🌐 Option 2: Use Remote Images

  • Click the ➕ Add button of the Media Node
  • Enter a public image http URL 🔗 or Hit Ctrl+V to paste an image (you need to focus the text field).
  • The image is fetched, if the link is valid.

Upload Local files to the Media Node

📊 Option 3: Import from Spreadsheet

  • Click Import data 📑
  • Select a TSV file đŸ“Ĩ (Click the â„šī¸ info button to know what structure is expected regarding those files)

Import a .tsv file to the Media Node


3ī¸âƒŖđŸ‘ī¸ Inspect Image & Text Field associations

  • Click on the Inspect Images đŸ–ŧī¸ button at the bottom of the Media Node.
  • Click on the image thumbnail to trigger a preview window 🔍 opens with the full image and some useful metadata.

Inspect Media Node Images


4ī¸âƒŖđŸ”— Connect Images to Your Prompt Chain

  • Connect the Media Node's output variables 🔌 to a Prompt Node's input variables.
  • In the Prompt Node, create a template variable đŸˇī¸, the same way you would for text input.

Connect Media Node to Prompt Node


5ī¸âƒŖđŸ” Inspect Responses on the Prompt Node

  • After executing the Prompt Node, Click the Inspect Responses tab or section within the Prompt Node interface.
  • Browse the list of responses generated by the LLM for each input (including images and text).

Inspect Prompt Node Responses


💡 Tutorial

See this tutorial for a step-by-step example of using Media Node in a ChainForge flow.


❓ FAQ

Is there a file size limit?
Yes! đŸšĢ Each image file should be under 50MB for best performance.

Can I delete images from the Media Node?
Yes! đŸ—‘ī¸ Select any image and click Delete to remove it from your flow.