# SDG Hub: Synthetic Data Generation Toolkit

[![Build](https://github.com/Red-Hat-AI-Innovation-Team/sdg_hub/actions/workflows/pypi.yaml/badge.svg?branch=main)](https://github.com/Red-Hat-AI-Innovation-Team/sdg_hub/actions/workflows/pypi.yaml)
[![Release](https://img.shields.io/github/v/release/Red-Hat-AI-Innovation-Team/sdg_hub)](https://github.com/Red-Hat-AI-Innovation-Team/sdg_hub/releases)
[![License](https://img.shields.io/github/license/Red-Hat-AI-Innovation-Team/sdg_hub)](https://github.com/Red-Hat-AI-Innovation-Team/sdg_hub/blob/main/LICENSE)
[![Tests](https://github.com/Red-Hat-AI-Innovation-Team/sdg_hub/actions/workflows/test.yml/badge.svg)](https://github.com/Red-Hat-AI-Innovation-Team/sdg_hub/actions/workflows/test.yml)
[![codecov](https://codecov.io/gh/Red-Hat-AI-Innovation-Team/sdg_hub/graph/badge.svg?token=SP75BCXWO2)](https://codecov.io/gh/Red-Hat-AI-Innovation-Team/sdg_hub)

## Overview

SDG Hub is designed to simplify data creation for LLMs, allowing users to chain computational units and build powerful flows for generating data and processing tasks. Define complex workflows using nothing but YAML configuration files.

## ✨ Key Features

- **Low-Code Flow Creation**: Build sophisticated data generation pipelines using simple YAML configuration files without writing any code.

- **Modular Block System**: Compose workflows from reusable, self-contained blocks that handle LLM calls, data transformations, and filtering.

- **LLM-Agnostic**: Works with any language model through configurable prompt templates and generation parameters.

- **Prompt Engineering Friendly**: Tune LLM behavior by editing declarative YAML prompts.

## 🚀 Installation

### Stable Release (Recommended)

```bash
pip install sdg-hub
```

### Development Version

```bash
pip install git+https://github.com/Red-Hat-AI-Innovation-Team/sdg_hub.git
```

## 📺 Video Tutorial

For a comprehensive walkthrough of sdg_hub:

[![SDG Hub Tutorial](https://img.youtube.com/vi/aGKCViWjAmA/0.jpg)](https://www.youtube.com/watch?v=aGKCViWjAmA)

## 🤝 Contributing

We welcome contributions from the community! Whether it's bug reports, feature requests, documentation improvements, or code contributions, please check out our [development guide](development.md).

## 📄 License

This project is licensed under the Apache 2.0 License - see the [LICENSE](https://github.com/Red-Hat-AI-Innovation-Team/sdg_hub/blob/main/LICENSE) file for details.

---