Repolode
Submit
GoogleChrome

GoogleChrome/lighthouse

Open-source tool that audits web pages for performance, accessibility, SEO and best practices, run from Chrome DevTools, a Chrome extension, or the Node CLI and module.

Open-source alternative to:PageSpeed InsightsWebPageTest

View on GitHubWebsite
Stars
30,924
Forks
9,772
Open issues
439
Last commit
5 hours ago

What is it?

Lighthouse analyzes web apps and web pages, collecting performance metrics and reporting on developer best practices. It runs a page in a local Chrome browser, applies simulated network and CPU throttling by default, and produces a scored report with categories for performance, accessibility, best practices and SEO.

You can run it from the Lighthouse panel in Chrome DevTools, through the Chrome Web Store extension, or with the Node CLI and programmatic Node module. The CLI can output HTML, JSON or CSV, audit multiple URLs from a file, and save traces and screenshots. Runs happen locally, and results are not sent to a remote server.

The tool is extensible through configuration, custom audits, and plugins. Several third-party services and CI integrations build on it, and the project requires Node 22 or later for the CLI.

Key features

  • 01Scores pages across performance, accessibility, best practices and SEO.
  • 02Runs from Chrome DevTools, the Chrome extension, the Node CLI or a Node module.
  • 03Outputs reports in HTML, JSON or CSV.
  • 04Applies configurable network and CPU throttling, with mobile and desktop presets.
  • 05Supports custom audits and plugins through configuration.
  • 06Audits multiple URLs in batch and supports authenticated pages via headers and cookies.

Use cases

  • Checking a site's load performance and Core Web Vitals before release.
  • Running automated performance and quality audits in CI pipelines.
  • Comparing page scores over time to catch regressions.
  • Auditing many URLs in batch for SEO and accessibility issues.

Quick start

  1. 1

    Install Lighthouse globally with npm

    npm install -g lighthouse
  2. 2

    Run an audit on a URL (the HTML report is written to a file)

    lighthouse https://airhorner.com/

Things to know

  • The Node CLI requires Node 22 (LTS) or later.
  • Audits need Chrome installed on the machine.

Topics

#performance#web-performance#auditing#accessibility#seo#chrome#nodejs#best-practices#audit#chrome-devtools

FAQ

What is lighthouse?
Open-source tool that audits web pages for performance, accessibility, SEO and best practices, run from Chrome DevTools, a Chrome extension, or the Node CLI and module. Lighthouse analyzes web apps and web pages, collecting performance metrics and reporting on developer best practices. It runs a page in a local Chrome browser, applies simulated network and CPU throttling by default, and produces a scored report with categories for performance, accessibility, best practices and SEO.
Is lighthouse free to use? What license does it have?
lighthouse is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is lighthouse still maintained?
Actively maintained. The last commit to lighthouse was on Oct 21, 2026.
What can I use lighthouse for?
Checking a site's load performance and Core Web Vitals before release. Running automated performance and quality audits in CI pipelines. Comparing page scores over time to catch regressions. Auditing many URLs in batch for SEO and accessibility issues.
How do I install lighthouse?
Install Lighthouse globally with npm: npm install -g lighthouse Run an audit on a URL (the HTML report is written to a file): lighthouse https://airhorner.com/
Where can I get lighthouse?
The source code and installation instructions are on GitHub: https://github.com/GoogleChrome/lighthouse

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects