Self-hosting

TulipFarm releases Huntsman, a lightweight self-hosted web scraper for AI pipelines

TulipFarm has released Huntsman, a self-hosted tool that converts web pages into clean Markdown using the Lightpanda browser engine.

Server rack processing documents into digital text
Illustration created for this article

TulipFarm has released Huntsman, a new open-source web scraping tool designed for developers building retrieval-augmented generation (RAG) systems and other AI applications. Published on GitHub in late October 2026, this self-hosted solution focuses on converting web content into clean Markdown format while maintaining compatibility with existing Firecrawl API standards.

What happened

Huntsman is built as a single Go binary and container image that renders JavaScript-heavy pages using the Lightpanda browser engine. Unlike heavier alternatives that rely on Playwright or full Chrome installations, Huntsman strips away ads, trackers, and cookie banners to deliver only the main content. The tool is distributed under the Apache-2.0 license, though it includes third-party components such as the Lightpanda browser under AGPL-3.0 and filter lists under GPLv3 or CC BY-SA 3.0.

The project provides a Firecrawl-compatible API, allowing teams to switch their existing clients to Huntsman by simply changing the base URL. It supports single-page scraping, batch processing of up to 1,000 URLs, and full-site crawling with configurable depth limits. The system uses a SQLite-backed queue for job management and includes a result cache to reduce redundant requests.

Key details

  • Performance benchmarks: On an AWS Graviton machine with 8 vCPUs and 16 GB of RAM, Huntsman processed 129 pages concurrently at 11.54 pages per second, significantly outperforming Firecrawl and Crawl4AI in the same test environment.
  • Resource efficiency: The tool scales efficiently on smaller hardware, handling 45 concurrent pages on a 2 vCPU, 4 GB machine without crashing or running out of memory.
  • Security features: Huntsman blocks private, loopback, and link-local addresses by default, respects robots.txt files, and runs as a non-root user inside containers.
  • Authentication: Supports bearer token authentication via environment variables, allowing for named tokens that log client names instead of raw secrets for easier auditing.
  • Clean output: Returns only Markdown and links, deliberately excluding screenshots, HTML, or JSON extraction to keep the payload small and focused on LLM consumption.
  • Configuration: All settings are managed through environment variables, including worker counts, cache TTLs, and adblock list selections.

Background

Web scraping for AI applications requires more than just downloading HTML. Modern websites often rely heavily on JavaScript to render content, meaning simple HTTP requests miss the actual text users see. Tools like Huntsman use headless browsers to execute this JavaScript, wait for the page to settle, and then extract the text. However, traditional browser automation tools can be resource-intensive, requiring significant CPU and memory to run multiple instances simultaneously.

For teams running their own infrastructure, managing these resources is critical. A scraper that crashes under load or consumes all available memory can disrupt other services on the same host. Huntsman addresses this by using Lightpanda, a lighter-weight browser engine, and by carefully managing concurrency based on available CPU and memory limits. This approach allows for higher throughput on modest hardware compared to heavier alternatives.

Why it matters

For engineering teams building RAG pipelines, the quality and cleanliness of input data directly impact the performance of their language models. Noise from navigation menus, footers, and advertisements can confuse AI agents and increase token costs. Huntsman’s focus on extracting only the main content helps ensure that the data fed into these systems is relevant and concise. This reduces the need for complex post-processing steps to clean up scraped data.

Operational reliability is another major concern for self-hosted tools. Many open-source scrapers struggle with stability when scaling up, often crashing or leaking memory during large crawls. The benchmarks provided by TulipFarm suggest that Huntsman maintains stability even under high concurrency, stopping only when page times increase rather than failing catastrophically. This predictability allows DevOps engineers to size their infrastructure more accurately and avoid unexpected outages.

Additionally, the drop-in compatibility with Firecrawl lowers the barrier to adoption. Teams already using Firecrawl can test Huntsman without rewriting their integration code. This flexibility is valuable for organizations that want to reduce dependency on external SaaS providers or lower their cloud computing costs by moving scraping workloads in-house.

What you can do

  • Test the Docker image: Run the published container on a local machine or staging server to evaluate its performance with your specific target websites.
  • Review the benchmarks: Examine the provided benchmark results to determine if Huntsman’s throughput meets your data ingestion requirements compared to your current solution.
  • Check license compliance: Verify that the combination of Apache-2.0, AGPL-3.0, and GPL licenses fits your organization’s open-source usage policies, especially regarding the Lightpanda component.
  • Configure security settings: Enable bearer token authentication and review the default restrictions on private addresses to ensure the scraper aligns with your network security policies.
  • Monitor resource usage: Use the environment variables to tune worker counts and memory limits based on your available hardware, ensuring the tool does not starve other services.
  • Integrate with search tools: Since Huntsman does not include search capabilities, pair it with a self-hosted search engine like SearXNG if you need to discover URLs before scraping them.

More news

All news