cribo

library0.8.2jsnpmunverified

Cribo is a Python source bundler that combines multi-module Python projects into a single .py file for easy deployment. The current stable version is 0.8.2. It is distributed as a Rust-based CLI tool via npm, with native binaries for Linux (x64, ARM64, glibc and musl), macOS (x64, Apple Silicon), and Windows (x64, ARM64). This approach ensures fast performance and zero Python runtime dependencies. Cribo is ideal for deploying to AWS Lambda, PySpark, or bundling Python scripts for CDK and Terraform workflows. The tool is optimized for simplicity and speed, unlike pip-based bundlers.

devops

npm install cribo

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · CRIBO

cribo

devopsjavascriptv0.8.2

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Installation and basic bundling of a Python project into a single .py file using Cribo.

# First, install Cribo globally npm install -g cribo # Bundle a Python project into a single file cribo --entry src/main.py --output bundle.py # Use with npx without installation npx cribo --entry src/main.py --output bundle.py

Debug

Known issues

breakingCribo requires Node.js >=18.0.0 to install via npm.

fix

Ensure Node.js v18 or later is installed before installing Cribo.

affects: <0.8.2

gotchaCribo bundles Python code but does not resolve external dependencies or pip packages.

fix

Use virtual environments or package managers to handle third-party dependencies separately.

affects: >=0.0.0

gotchaThe Cribo binary must be compatible with your target runtime architecture; automatic detection may fail in some environments.

fix

Manually specify the target binary architecture using the --platform flag if needed.

affects: >=0.0.0

deprecatedVersion 0.x is considered early-stage; the CLI API may change without notice.

fix

Pin to a specific version and test bundled output after upgrades.

affects: <1.0.0

Errors

Common errors & fixes

Error: Cannot find module 'cribo'

Cribo is not installed globally or local node_modules is missing.

fix

Run 'npm install -g cribo' to install globally, or use 'npx cribo'.

EBADARCH: Unsupported architecture

The current OS/architecture is not supported by the bundled binaries.

fix

Ensure you are using a supported platform: Linux x64/ARM64, macOS x64/ARM64, Windows x64/ARM64. For unsupported platforms, try building from source.

Error: Python entry point not found: src/main.py

The specified entry file does not exist or the path is incorrect.

fix

Verify the entry file path and ensure it is relative or absolute. Use 'ribo --entry ./src/main.py'.

Upgrade

Version history

0.8.2latest on npm

Audit

Dependencies

noderequiredrequired to run the npm installer; Cribo itself is a Rust binary

Agent activity

6 hits · last 30 days

node

Resources

githubhttps://github.com/ophidiarium/cribo ↗

packagecribo ↗

homepagehttps://github.com/ophidiarium/cribo ↗