Image
A RocketRide embedding node that turns image documents or image streams into vectors for a multimodal vector store; choose it when the source is an image rather than text or video.
About Hugging Face
Hugging Face develops widely used open-source tooling and model repositories for machine learning. Its Transformers library provides common interfaces for loading and running pretrained models, including vision models.
What it does
The node accepts image documents or a raw image stream and adds an embedding plus the producing embedding_model. Choose it over embedding_transformer for visual content and over embedding_video when frames have already been extracted. For the documents lane, every document must be an Image document; another type raises ValueError.
Lanes
| Lane in | Lane out | Description |
|---|---|---|
documents | documents | Decodes Image documents and enriches them with an embedding. |
image | documents | Buffers a raw image stream and emits an embedded Image document. |
Profiles
Default: OpenAI - 16x16 - good performance, lower memory (openai-patch16).
| Profile | Model | Context |
|---|---|---|
openai-patch16 (default) | openai/clip-vit-base-patch16 | Default vision model. |
openai-patch32 | openai/clip-vit-base-patch32 | Alternative CLIP profile. |
google16x224 | google/vit-base-patch16-224 | ViT profile. |
custom | User-provided | Enter a compatible Hugging Face model identifier. |
Configuration
Choose a supplied profile for the corresponding bundled model; use Custom only when the exact model identifier is known to work with the implementation. The output vector shape comes from the chosen model, so select the same profile used when building the target vector index.
Model
The default is openai/clip-vit-base-patch16. Model names containing clip use image features from the CLIP path; other names use the model output path. Change this only when the destination index and retrieval configuration can accommodate the new vector shape; a mismatch will make stored and query vectors incompatible.
Requirements
The node declares GPU capability. Its embedding model is loaded through the model provider; the source does not define a CPU-only fallback, so provision a compatible model runtime when using this node.
Notes
Image stream output
On completion of an image stream, the node emits a base64-backed Image document and assigns a chunkId. Stream source details and the source stem are retained when supplied; documents on the documents lane retain their upstream provenance.
Upstream docs
Schema
| Field | Type | Description | Default |
|---|---|---|---|
embedding.model | string | Model name Hugging face model to use for embedding | |
embedding.profile | string | Model Embedding model | "openai-patch16" |
Dependencies
transformersaccelerate