​

SDKs Overview

​

Available SDKs

​

TypeScript/JavaScript

• Installation: npm install gumnut-sdk
• GitHub: github.com/gumnut-ai/photos-sdk-typescript
• Features: Full TypeScript support, universal compatibility, automatic retries, file upload helpers

​

Python

• Installation: pip install gumnut-sdk
• GitHub: github.com/gumnut-ai/photos-sdk-python
• Features: Python 3.9+ support, async/await, type hints, context managers

​

Common Features

• Authentication: API key and OAuth token support, environment variable configuration
• Reliability: Automatic retries with exponential backoff, comprehensive error handling
• File Handling: Multiple upload formats, stream support for large files
• Pagination: Automatic pagination helpers and iterator patterns
• Type Safety: Full type definitions and IDE autocompletion

​

Getting Started

​

1. Install

# TypeScript/JavaScript
npm install gumnut-sdk

# Python
pip install gumnut-sdk

​

2. Basic Usage

// Initialize client
const client = new Gumnut({ apiKey: "your_key" });

// Upload an asset
const asset = await client.assets.create({ /* ... */ });

// Create an album
const album = await client.albums.create({ /* ... */ });

// Add to album
await client.albums.addAssets(album.id, [asset.id]);

​

Direct API Usage

curl -X GET https://api.gumnut.ai/api/assets \
  -H "Authorization: Bearer YOUR_API_KEY"