flowos-ibm

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

This bundle ships three components:

• DB2VectorStoreComponent — wraps the DB2VS LangChain-compatible vector store and exposes Db2's native vector search through FlowOS'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

pip install flowos-ibm

The bundle is registered automatically via the flowos.extensions entry-point. After install, restart your FlowOS 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

cd src/bundles/ibm
pip install -e .
flowos_core extension validate src/flowos_ibm

Manifest

The extension manifest is shipped at src/flowos_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 (flowos_core.components.ibm.<module>.<Class> and the package-level flowos_core.components.ibm.<Class> forms) are rewritten to the new namespaced IDs by the migration table in src/flowos-core/src/flowos_core/extension/migration/migration_table.json.