Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Installation

Binary Install

One-liner (Linux/macOS/Windows via WSL)

curl -sL https://b4n1.com/install | bash

This downloads the correct binary for your platform and installs it to ~/.local/bin/b4n1web.

Manual Download

Download from GitHub Releases:

PlatformFile
Linux x86_64b4n1web-linux-amd64
Linux ARM64b4n1web-linux-arm64
macOS Intelb4n1web-macos-x64
macOS Apple Siliconb4n1web-macos-arm64
Windows x86_64b4n1web-windows-amd64.exe
Windows ARM64b4n1web-windows-arm64.exe

Make executable (Linux/macOS):

chmod +x b4n1web-*
sudo mv b4n1web-* /usr/local/bin/b4n1web

Verify Installation

b4n1web --version
# b4n1web 0.9.5

Python SDK

# From PyPI
pip install b4n1-web

# Or with UV
uv pip install b4n1-web

Requires: Python 3.8+

The wheel includes binaries for all 6 platforms.


JavaScript/TypeScript SDK

# npm
npm install b4n1-web

# pnpm
pnpm add b4n1-web

# yarn
yarn add b4n1-web

Requires: Node.js 18+

The package includes binaries for all 6 platforms.


Java SDK

Maven

<dependency>
    <groupId>com.b4n1</groupId>
    <artifactId>b4n1-web</artifactId>
    <version>0.9.5</version>
</dependency>

Gradle

implementation 'com.b4n1:b4n1-web:0.9.5'

Requires: Java 11+

The JAR includes native binaries for all 6 platforms.


C# .NET SDK

dotnet add package B4n1Web

Requires: .NET 6.0+

The NuGet package includes native binaries for all 6 platforms.


Platform Compatibility

All SDKs bundle binaries for these 6 platforms:

PlatformBinaryPythonJSJavaC#
Linux x86_64b4n1web-linux-amd64
Linux ARM64b4n1web-linux-arm64
macOS Intelb4n1web-macos-x64
macOS Apple Siliconb4n1web-macos-arm64
Windows x86_64b4n1web-windows-amd64.exe
Windows ARM64b4n1web-windows-arm64.exe

Chromium Dependency

Chromium is downloaded automatically when you use Render mode. No separate installation needed.

Supported platforms for Chromium:

  • Linux x86_64 ✅
  • Linux ARM64 ✅
  • macOS Intel ✅
  • macOS Apple Silicon ✅
  • Windows x86_64 ✅
  • Windows ARM64 ✅

The first Render mode call downloads Chromium (~160MB) to ~/.b4n1web/chromium/. Subsequent calls reuse it.


Troubleshooting Install

Binary not found in PATH

# Add to PATH
export PATH="$HOME/.local/bin:$PATH"
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc

Permission denied

chmod +x ~/.local/bin/b4n1web

Chromium download fails

Check internet connection. Chromium is downloaded from Google’s storage. For offline environments, pre-download and place in ~/.b4n1web/chromium/.

Architecture mismatch

Ensure you’re using the correct binary for your platform:

uname -m  # x86_64 or aarch64