Installation Guide

Get up and running with Crawlingo on your preferred runtime environment. Precompiled native binaries and wheels are provided for all major platforms.

5 min read Updated July 2026

System Prerequisites

Crawlingo compiles to native code for maximum performance. Pre-built packages are distributed with precompiled binaries, so you do not need a Rust compiler installed locally unless you compile from source.

OS / PlatformPrerequisitesSupported Architectures
Linuxglibc 2.28+ (Debian 10+, Ubuntu 20.04+, CentOS 8+)x86_64, aarch64 (ARM64)
macOSmacOS 11+ (Big Sur or newer)Intel, Apple Silicon (M1/M2/M3)
WindowsWindows 10+ / Server 2019+AMD64 (x64)

Python SDK

The Python SDK is distributed as precompiled binary wheels on PyPI. Requires Python 3.8 to 3.13.

terminal
bash
# Install via pip
pip install crawlingo

# Or use poetry
poetry add crawlingo

# Or use pipenv
pipenv install crawlingo

Node.js (TypeScript) SDK

The Node.js SDK includes precompiled native bindings built via napi-rs. Requires Node.js 18 or newer.

terminal
bash
# Install via npm
npm install crawlingo

# Or use yarn
yarn add crawlingo

# Or use pnpm
pnpm add crawlingo

Rust Native Crate

For Rust developers, add the dependency directly to your crate. Requires Rust stable 1.70+.

Cargo.toml
toml
[dependencies]
crawlingo = "0.1.0"
tokio = { version = "1", features = ["full"] }

Verifying Your Install

Verify that the native bindings load correctly by importing and reading the library version:

Python Verification
python
import crawlingo
print(crawlingo.__version__) # "0.1.0"
Node.js Verification
javascript
const { Session } = require('crawlingo');
const s = new Session();
console.log('Crawlingo loaded successfully:', s !== null);
⚠️

Linux Musl Compatibility

If you are deploying on lightweight Alpine Linux Docker containers, make sure to use `crawlingo-musl` or compile the native library from source, as standard wheels target glibc.