Installation

Package Managers

bun

bun add bun-image-turbo

npm

npm install bun-image-turbo

yarn

yarn add bun-image-turbo

pnpm

pnpm add bun-image-turbo

Requirements

• Bun 1.0+ or Node.js 18+
• No additional dependencies required (prebuilt binaries included)

Supported Platforms

Prebuilt binaries are available for all major platforms:

Platform	Architecture	Supported	HEIC
macOS	ARM64 (M1/M2/M3/M4/M5)	✅	✅
macOS	x64 (Intel)	✅	❌
Linux	x64 (glibc)	✅	❌
Linux	x64 (musl/Alpine)	✅	❌
Linux	ARM64 (glibc)	✅	❌
Windows	x64	✅	❌
Windows	ARM64	✅	❌

All Platforms Supported

All platforms listed above are fully supported. HEIC/HEIF support is only available on macOS ARM64 due to libheif requirements. All other image formats (JPEG, PNG, WebP, GIF, BMP, TIFF, ICO) work on all platforms.

Verifying Installation

import { version, metadata } from 'bun-image-turbo';

// Check version
console.log(`bun-image-turbo v${version()}`);

// Test with an image
const buffer = await Bun.file('image.jpg').arrayBuffer();
const info = await metadata(Buffer.from(buffer));
console.log(info);

Building from Source

If you need to build from source (requires Rust 1.70+):

# Clone the repository
git clone https://github.com/nexus-aissam/bun-image-turbo.git
cd bun-image-turbo

# Install dependencies
bun install

# Build native module
bun run build

# Build TypeScript
bun run build:ts

Build Requirements

• Rust 1.70+
• NASM (for TurboJPEG SIMD)
• CMake 3.10+
• C/C++ compiler

macOS Build Dependencies

brew install nasm cmake

Linux Build Dependencies

# Ubuntu/Debian
sudo apt-get install nasm cmake build-essential

# Fedora
sudo dnf install nasm cmake gcc-c++