https://github.com/transloadit/node-sdk

Transloadit's official Node.js SDK
https://github.com/transloadit/node-sdk

encoding file-api javascript sdk transloadit uploading

Last synced: 17 days ago
JSON representation

Transloadit's official Node.js SDK

• Host: GitHub
• URL: https://github.com/transloadit/node-sdk
• Owner: transloadit
• License: mit
• Created: 2014-06-04T05:30:19.000Z (almost 12 years ago)
• Default Branch: main
• Last Pushed: 2026-05-04T14:59:02.000Z (28 days ago)
• Last Synced: 2026-05-04T16:37:28.811Z (28 days ago)
• Topics: encoding, file-api, javascript, sdk, transloadit, uploading
• Language: TypeScript
• Homepage: https://transloadit.com
• Size: 3.84 MB
• Stars: 71
• Watchers: 5
• Forks: 27
• Open Issues: 8
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Agents: AGENTS.md

Awesome Lists containing this project

README

          
[![Build Status](https://github.com/transloadit/node-sdk/actions/workflows/ci.yml/badge.svg)](https://github.com/transloadit/node-sdk/actions/workflows/ci.yml)

[![Coverage](https://codecov.io/gh/transloadit/node-sdk/branch/main/graph/badge.svg)](https://codecov.io/gh/transloadit/node-sdk)



  

    

    

    

  



# Transloadit JavaScript/TypeScript SDKs

Monorepo for Transloadit SDKs, shared packages, and the MCP server.

[![Transloadit Server MCP server](https://glama.ai/mcp/servers/transloadit/node-sdk/badges/card.svg)](https://glama.ai/mcp/servers/transloadit/node-sdk)

## Packages

- `@transloadit/node` — Node.js SDK + CLI. See `packages/node/README.md`.

- `transloadit` — Stable unscoped package (built from `@transloadit/node`).

- `@transloadit/mcp-server` — MCP server (Streamable HTTP + stdio). See `packages/mcp-server/README.md`.

- `@transloadit/types` — Shared TypeScript types.

- `@transloadit/utils` — Shared utilities.

- `@transloadit/zod` — Zod schemas for Transloadit APIs.

## Quick start

### Node SDK

```ts

import { Transloadit } from '@transloadit/node'

const client = new Transloadit({

  authKey: process.env.TRANSLOADIT_KEY as string,

  authSecret: process.env.TRANSLOADIT_SECRET as string,

})

const result = await client.createAssembly({

  params: {

    steps: {

      ':original': { robot: '/upload/handle' },

    },

  },

  files: { file: '/path/to/file.jpg' },

  waitForCompletion: true,

})

```

### MCP server

See `packages/mcp-server/README.md` for MCP setup, auth, and tool docs.

## Development

- Install: `corepack yarn`

- Checks + unit tests: `corepack yarn check`

- Node SDK unit tests: `corepack yarn workspace @transloadit/node test:unit`

## Repo notes

- Docs live under `docs/` (non-MCP).

- The `transloadit` package is prepared via `scripts/prepare-transloadit.ts`.

- PR checks enforce that tracked files in `packages/transloadit/` stay in sync with `@transloadit/node`.

- Tarball fingerprint parity remains available as a manual release/debug tool via `corepack yarn parity:transloadit`.