Installation

Install the SDK via pip:

pip install syncora-sdk

Requires Python 3.7 or higher.

Quick Start:

1. Set your API key

Head over to Syncora, register for an account, and generate your API key from the dashboard.

1. Initialize the client and generator

from syncora_sdk import SyncoraClient, SyntheticDataGenerator
from pathlib import Path


# Client with API key
client = SyncoraClient(api_key="your-syncora-api-key")

# Instantiate the synthetic data generator
syntheticDataGenerator = SyntheticDataGenerator(client)

1. Generate synthetic tabular data from a CSV file

file_path = Path("Sonar.csv")

response = syntheticDataGenerator.generate_from_file(
    file_path=file_path,
    type="Tabular",
    numberOfRows=100,
    targetColumn="Freq_1"
)

print(response)

This will return a JSON response with a link to download the generated synthetic dataset.

API Reference

SyncoraClient

Method	Description
init(api_key)	Initialize client with your api key.

SyntheticDataGenerator

generate_from_file(file_path, type, ...)

Method	Description
generate_from_file(file_path, type, ...)	Generate synthetic data from a file (CSV, JSONL, etc.)

Common Parameters:

• type (str): Type of data to generate. One of ["Tabular", "TimeSeries", "JSONL"]

• numberOfRows (int): Number of rows or records to generate.

• targetColumn (str, optional): Column on which to focus generation for tabular data.

---

Error Handling

All SDK methods raise SyncoraError on failure. You can catch and inspect:

from syncora_sdk import SyncoraError

try:
    syntheticDataGenerator.generate_from_file(...)
except SyncoraError as e:
    print(f"Error: {e.code} – {e.message}")