# alixaxel/chrome-aws-lambda

Chromium Binary for AWS Lambda and Google Cloud Functions

Repository: https://github.com/alixaxel/chrome-aws-lambda
Canonical: https://ross.abutalabs.com/products/chrome-aws-lambda
Language: TypeScript
License: MIT
License Family: permissive
Topics: aws-lambda, puppeteer, chromium, serverless, aws, ansible
Last push: 2024-09-03T21:05:59+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 3086, "days_push": 729, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3285, forks 294 (observed 2026-08-28T04:07:53.726785+00:00)

## What it is
A TypeScript library that ships a size-optimized Chromium binary designed to run headless browser automation with Puppeteer (or Playwright) inside AWS Lambda and Google Cloud Functions. It exposes launch arguments, viewport defaults, and the executable path so serverless functions can drive a real browser out of the box.

## Use cases
- run puppeteer in aws lambda
- scrape websites from a serverless function
- generate pdf screenshots of pages in lambda
- render javascript-heavy pages on google cloud functions
- launch headless chromium with minimal memory footprint
- automate browser tasks in node.js serverless runtimes

## When to choose
- you need headless Chromium inside AWS Lambda or Google Cloud Functions where the default binary is too large
- you want a drop-in executablePath and args for puppeteer-core or playwright-core in serverless environments

## When to avoid
- you run browsers on regular servers or containers where the standard Puppeteer/Playwright binaries work fine
- you need the latest Chromium features immediately, since binaries track stable releases with a lag
- your project uses a newer Puppeteer major version that this package no longer ships binaries for

## Facets
- artifact type: library
- maturity: maintenance
- function: web-scraping, browser-extension, http-client
- domain: web-development, cloud-computing, developer-tools
- platform: serverless, cloud
- tags: chromium, puppeteer, headless-browser, aws-lambda, google-cloud-functions, playwright, automation, nodejs

## Member repositories
- alixaxel/chrome-aws-lambda (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:53.726785+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:43:13.339371+00:00, confidence not recorded.
  - readme: https://github.com/alixaxel/chrome-aws-lambda (fetched 2026-08-28T04:07:53.726785+00:00, sha 845a83fa47fc)
  - registry_npm: https://registry.npmjs.org/chrome-aws-lambda (fetched 2026-08-29T09:36:09.426671+00:00, sha ebad60e17931)
- Data as of 2026-08-30T08:39:29.467469+00:00.