README.md
June 4, 2026 ยท View on GitHub
Composable blocks and flows for synthetic data generation
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.
| Skill | Description |
|---|---|
setup-guide | Guided first-time configuration |
data-generation | Run synthetic data generation using a flow |
flow-browser | Browse and inspect available flows |
License
Apache License 2.0 -- see LICENSE.
Built by the Red Hat AI Innovation Team