ContextQMD
Back to Langflow

lfx-ibm

src/bundles/ibm/README.md

1.11.0.dev12.3 KB
Original Source

lfx-ibm

IBM components — Db2 Vector Store plus watsonx.ai LLM and embeddings — as a standalone Langflow Extension Bundle.

This bundle ships three components:

  • DB2VectorStoreComponent — wraps the DB2VS LangChain-compatible vector store and exposes Db2's native vector search through Langflow's standard vector-store palette entry.
  • WatsonxAIComponent — chat/text-generation against IBM watsonx.ai foundation models via langchain-ibm's ChatWatsonx.
  • WatsonxEmbeddingsComponent — embeddings via watsonx.ai's WatsonxEmbeddings model.

It follows the documented porting recipe in src/bundles/PORTING.md.

Install

bash
pip install lfx-ibm

The bundle is registered automatically via the langflow.extensions entry-point. After install, restart your Langflow server; the three components appear in the palette under the ibm bundle group.

Platform notes:

  • The ibm-db driver does not ship a prebuilt wheel for linux/aarch64; the dep is gated with a marker so pip install succeeds on that architecture, but DB2VectorStoreComponent will fail to build the vector store at runtime there. Use an x86_64 image or install ibm-db from source if you need Db2 on aarch64.
  • ibm-watsonx-ai (>=1.5.13) and langchain-ibm (>=1.1.0) added Python 3.14 support upstream, so the watsonx components are importable on every supported Python version (3.10-3.14). Earlier releases capped at <3.14; the bundle pins were bumped to pick up the 3.14-capable builds.

Develop

bash
cd src/bundles/ibm
pip install -e .
lfx extension validate src/lfx_ibm

Manifest

The extension manifest is shipped at src/lfx_ibm/extension.json and points at the bundle at components/ibm. Components register under the canonical namespaced IDs:

  • ext:ibm:DB2VectorStoreComponent@official
  • ext:ibm:WatsonxAIComponent@official
  • ext:ibm:WatsonxEmbeddingsComponent@official

Migration

Saved flows referencing the legacy bare class names (DB2VectorStoreComponent, WatsonxAIComponent, WatsonxEmbeddingsComponent) or the old import paths (lfx.components.ibm.<module>.<Class> and the package-level lfx.components.ibm.<Class> forms) are rewritten to the new namespaced IDs by the migration table in src/lfx/src/lfx/extension/migration/migration_table.json.