Getting Started

Nginjen is a privacy-first browser automation engine. It bundles everything into a single Rust binary: Chromium management, stealth injection, HTTP API, web search, and session orchestration.

Install

Download Pre-built Binary

Grab the latest release from GitHub Releases.

Platform	File
Linux x86_64	nginjen-x86_64-unknown-linux-gnu-v*.tar.gz
Linux ARM64	nginjen-aarch64-unknown-linux-gnu-v*.tar.gz
macOS ARM64	nginjen-aarch64-apple-darwin-v*.tar.gz
Windows x86_64	nginjen-x86_64-pc-windows-msvc-v*.zip

# Linux/macOS
tar xzf nginjen-*-v*.tar.gz
sudo mv nginjen /usr/local/bin/

# Verify
nginjen --version

Build from Source

git clone https://github.com/codecoradev/nginjen.git
cd nginjen
cargo build --release
./target/release/nginjen --version

Prerequisites: Rust 1.85+ (edition 2024).

First Run

On first use, Nginjen auto-downloads a compatible Chromium build. No manual setup needed.

# Scrape a page
nginjen scrape https://example.com

# Take a screenshot
nginjen screenshot https://example.com -o page.png

# Run diagnostics
nginjen doctor

# Search the web
nginjen search "rust async" --backend meta --limit 10

Start the API Server

nginjen serve

The server starts on http://127.0.0.1:9090. Verify it works:

curl http://127.0.0.1:9090/health

{"status": "ok", "version": "0.12.0"}

Configuration

Create a config file for persistent settings:

mkdir -p ~/.config/nginjen
cp config.example.toml ~/.config/nginjen/config.toml

Or pass a custom path:

nginjen serve --config /path/to/config.toml

See the Configuration page for all options.

What's Next

• CLI Reference for all commands and flags
• Stealth Engine to understand fingerprint consistency
• Web Search for built-in search backends
• API Reference for HTTP endpoints