Getting Started with Helix SDKs

Welcome to the Helix Connect SDK Documentation. This site provides comprehensive guides for integrating with the Helix Connect Data Marketplace using our official SDKs.

What is Helix Connect?

Helix Connect is a secure, scalable platform for exchanging datasets between data producers and consumers. Our SDKs make it easy to:

• Download datasets you've subscribed to
• Upload datasets as a producer
• Receive notifications when datasets are updated
• Manage subscriptions and access control

Available SDKs

SDK	Language	Status	Installation
TypeScript	TypeScript/Node.js	Production	npm install @helix-tools/sdk-typescript
Python	Python 3.8+	Production	pip install helix-connect
Go	Go 1.21+	Production	go get github.com/helix-tools/sdk-go

Key Features

Enterprise-Grade Security

Your data is protected with industry-leading security standards:

• End-to-end encryption — Data is encrypted in transit and at rest
• Secure authentication — API keys with fine-grained access control
• Compliance ready — Built for enterprise security requirements

Simple Integration

Three straightforward classes for every use case:

• Consumer — Subscribe to and download datasets from producers
• Producer — Publish your datasets to subscribers
• Admin — Manage your organization's platform settings

Real-Time Updates

Never miss a dataset update:

• Instant notifications when new data is available
• Automatic downloads — configure once, receive updates automatically
• Flexible polling — pull updates on your schedule

Quick Start

1. Get Your Credentials

Contact support@helix.tools to obtain:

• AWS Access Key ID
• AWS Secret Access Key
• Customer ID (UUID format)

2. Install an SDK

TypeScript

npm install @helix-tools/sdk-typescript

Python

pip install helix-connect

Go

go get github.com/helix-tools/sdk-go

3. Connect and Download

TypeScript

import { HelixConsumer } from '@helix-tools/sdk-typescript';

const consumer = new HelixConsumer({
  awsAccessKeyId: process.env.AWS_ACCESS_KEY_ID!,
  awsSecretAccessKey: process.env.AWS_SECRET_ACCESS_KEY!,
  customerId: process.env.HELIX_CUSTOMER_ID!,
});

// List available datasets
const datasets = await consumer.listDatasets();

// Download a dataset
await consumer.downloadDataset({
  datasetId: 'your-dataset-id',
  outputPath: './data/my_dataset.csv',
});

Python

from helix_connect import HelixConsumer

consumer = HelixConsumer(
    aws_access_key_id="your-access-key",
    aws_secret_access_key="your-secret-key",
    customer_id="your-customer-id"
)

# List available datasets
datasets = consumer.list_datasets()

# Download a dataset
consumer.download_dataset(
    dataset_id="your-dataset-id",
    output_path="./data/my_dataset.csv"
)

Go

import "github.com/helix-tools/sdk-go"

consumer, err := helix.NewConsumer(&helix.Config{
    AWSAccessKeyID:     os.Getenv("AWS_ACCESS_KEY_ID"),
    AWSSecretAccessKey: os.Getenv("AWS_SECRET_ACCESS_KEY"),
    CustomerID:         os.Getenv("HELIX_CUSTOMER_ID"),
})

// List available datasets
datasets, err := consumer.ListDatasets()

// Download a dataset
err = consumer.DownloadDataset("your-dataset-id", "./data/my_dataset.csv")

Next Steps

• TypeScript developers: Start with TypeScript Installation
• Python developers: Start with Python Installation
• Go developers: Start with Go Installation

Support

• Documentation: You're reading it!
• GitHub Issues: github.com/helix-tools/sdk-docs/issues
• Email: support@helix.tools