Skip to main content

Input Components

Input components (SmartHopper → B. Input) package Grasshopper data, files, web pages, forum posts, or system instructions into an Input > (>) wire that any Output component can consume.

Primitives & lists​

Single-value inputs package one item per value; * List to AI components collapse an entire list (branch) into a single AI input so the model sees the whole list in one call.

IconComponentNicknamePackagesPreview
Text to AI iconText to AIText2AIA single text prompt or messagetext-to-ai
Text List to AI iconText List to AITextList2AIA list of strings as one JSON array per branchtext-list-to-ai
Number to AI icon Number List to AI iconNumber to AI / Number List to AINum2AI / NumList2AIA single number, or a list of numbers per branchnumber-to-ai number-list-to-ai
Integer to AI icon Integer List to AI iconInteger to AI / Integer List to AIInt2AI / IntList2AIA single integer, or a list of integers per branchinteger-to-ai integer-list-to-ai
Boolean to AI icon Boolean List to AI iconBoolean to AI / Boolean List to AIBool2AI / BoolList2AIA single boolean, or a list of booleans per branchboolean-to-ai boolean-list-to-ai
JSON to AI iconJSON to AIJson2AIValidated JSON textjson-to-ai

Media, files, web & canvas​

IconComponentNicknameWhat it packagesPreview
Image to AI iconImage to AIImg2AIAn image (Bitmap, file path, URL, data URI, or base64) for vision-capable models.image-to-ai
Audio to AI iconAudio to AIAudio2AIA local audio file (.mp3, .wav, .m4a, .ogg, .flac) for audio-capable models.audio-to-ai
File to AI iconFile to AIFile2AILocal documents (PDF, DOCX, XLSX, PPTX, HTML, CSV, JSON, XML, TXT, EML, EPUB, RTF…) converted to Markdown, with embedded images materialized into the payload for vision-capable models. Also outputs the converted Markdown and detected Format.file-to-ai
Web to AI iconWeb to AIWeb2AIWeb page URLs fetched and converted to Markdown, with page images materialized into the payload for vision-capable models. Also outputs the extracted Markdown.web-to-ai
Canvas to AI iconCanvas to AIGhJSON2AIThe active Grasshopper canvas (or selected/filtered components) exported as GhJSON. Also outputs the GhJSON string.canvas-to-ai

Forum posts & topics​

Fetch a single post (by Post ID) or a whole thread (by Topic ID, with optional Max Posts) and output both Input > and the raw Post JSON / Topic JSON:

IconComponentNicknameSourcePreview
McNeel Post to AI icon McNeel Topic to AI iconMcNeel Post to AI / McNeel Topic to AIMcNeelPost2AI / McNeelTopic2AIMcNeel Discourse forummcneel-post-to-ai mcneel-topic-to-ai
Ladybug Post to AI icon Ladybug Topic to AI iconLadybug Post to AI / Ladybug Topic to AILadybugPost2AI / LadybugTopic2AILadybug Tools forumladybug-post-to-ai ladybug-topic-to-ai
Discourse Post to AI icon Discourse Topic to AI iconDiscourse Post to AI / Discourse Topic to AIDiscoursePost2AI / DiscourseTopic2AIAny Discourse forum (pass Base URL)discourse-post-to-ai discourse-topic-to-ai

Prompt and context inputs​

IconComponentNicknameWhat it doesPreview
AI Prompt iconAI PromptAIPromptPackages a system prompt (instructions that set the AI's role, tone, or rules) into Input >.ai-prompt
AIContext iconAIContextAICtxRetrieves live data from a registered context provider by Provider ID (e.g., time, file, environment, selection, viewport) and outputs both Input > and a human-readable Display string. Use Context Providers (A. AI) to list available IDs.ai-context

Combining multiple inputs​

Wire several input components into the same Input > parameter on an Output component (hold Shift while wiring, or use Grasshopper's Merge) to combine them into a single AI call:

Combining several input components into one AI request

Token awareness

Full files, web pages, and unfiltered canvas exports (Include Runtime Data = True) can be large. Filter canvas exports or summarize long documents first when working with smaller context windows.