README.md

June 4, 2026 ยท View on GitHub

SDG Hub

Composable blocks and flows for synthetic data generation

Docs PyPI Tests Python 3.10+ License Coverage Ask DeepWiki


SDG Hub Demo

SDG Hub is a Python framework for building synthetic data generation pipelines. Chain LLM, parsing, transform, filtering, and agent blocks into YAML-defined flows -- then generate training data at scale.

Get Started

pip install sdg-hub
from sdg_hub import FlowRegistry, Flow

# Discover and load a built-in flow
FlowRegistry.discover_flows()
flow = Flow.from_yaml(FlowRegistry.get_flow_path("MCP Server Distillation"))

# Configure and run
flow.set_model_config(model="openai/gpt-4o")
result = flow.generate(dataset)

See the Quick Start for a full walkthrough, or browse all built-in flows.

Documentation

Full documentation at ai-innovation.team/sdg_hub

  • Installation -- setup, optional dependencies, development install
  • Quick Start -- end-to-end walkthrough from loading a flow to generating data
  • Core Concepts -- blocks, flows, registries, and dataset handling
  • Block Reference -- LLM, parsing, transform, filtering, agent, and custom blocks
  • Flow Reference -- YAML schema, built-in flows, custom flows
  • API Reference -- auto-generated from source
  • Contributing -- development setup and contribution guidelines

Coding Agent Plugin

SDG Hub is available as a plugin for two coding agents, bringing synthetic data generation directly into your coding workflow.

Claude Code

Via org marketplace (recommended โ€” includes all Red Hat AI plugins):

/plugin marketplace add Red-Hat-AI-Innovation-Team/plugins
/plugin install sdg-hub@Red-Hat-AI-Innovation-Team/plugins

Via this repo directly:

/plugin marketplace add Red-Hat-AI-Innovation-Team/sdg_hub
/plugin install sdg-hub@Red-Hat-AI-Innovation-Team/sdg_hub

From a local clone:

git clone https://github.com/Red-Hat-AI-Innovation-Team/sdg_hub.git
/plugin marketplace add /path/to/sdg_hub
Codex CLI
codex plugin marketplace add Red-Hat-AI-Innovation-Team/plugins

Then install the plugin from the marketplace. See .codex-plugin/INSTALL.md for manual installation.

After Installing

Invoke the setup-guide skill to configure your LLM provider and model.

SkillDescription
setup-guideGuided first-time configuration
data-generationRun synthetic data generation using a flow
flow-browserBrowse and inspect available flows

License

Apache License 2.0 -- see LICENSE.


Built by the Red Hat AI Innovation Team