# liam-hq/liam

Automatically generates beautiful and easy-to-read ER diagrams from your database.

Repository: https://github.com/liam-hq/liam
Canonical: https://ross.abutalabs.com/products/liam
Homepage: https://liambx.com
Language: TypeScript
License: Apache-2.0
License Family: permissive
Topics: data-visualization, database, database-schema, documentation, documentation-tool, entity-relationship-diagram, er-diagram, erd, nodejs, orm, postgresql, reactjs, ruby-on-rails, sql, typescript, visualization, webassembly, prisma, react-flow, tbls
Last push: 2026-08-26T23:08:07+00:00

## Health v2 (maintenance only)
Score: 71/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 46, longevity 54
- inputs: {"age_days": 756, "days_push": 7, "days_rel": 282, "gap_med": 0, "n_releases_24m": 160}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 5093, forks 236 (observed 2026-08-28T04:09:09.657617+00:00)

## What it is
Liam ERD is an open-source tool that automatically generates beautiful, interactive entity-relationship diagrams from database schema files such as SQL dumps, Prisma schemas, and Rails schema.rb. It ships as a web app (liambx.com), an npm CLI for local/CI-CD use, and supports many schema formats including PostgreSQL, MySQL, Drizzle, and tbls.

## Use cases
- generate an ER diagram from a postgres pg_dump schema file
- visualize a prisma schema as an interactive diagram
- document a ruby on rails db/schema.rb as an ERD
- auto-generate up-to-date ER diagrams in CI/CD on every commit
- explore and share filtered views of a large database schema with teammates
- reverse engineer an existing database schema into a readable diagram

## When to choose
- you need interactive, shareable ER diagrams with zoom, filtering, and relationship highlighting
- your schema lives in SQL dumps, Prisma, Rails, Drizzle, or other supported formats
- you want zero-config diagram generation or CI/CD-automated schema docs
- you handle 100+ table schemas and need good performance

## When to avoid
- you need to edit or design schemas visually rather than visualize existing ones
- you need diagrams from formats not supported by the parser
- you require a desktop-only offline tool with no web component

## Facets
- artifact type: application
- maturity: active
- function: data-visualization, documentation, parser, web-scraping
- domain: databases, data-visualization, documentation, developer-tools, web-development
- platform: cli, browser, self-hosted
- tags: er-diagram, erd, database-schema, schema-visualization, prisma, ruby-on-rails, postgresql, react-flow, static-site, ci-cd, web-server, nodejs

## Member repositories
- liam-hq/liam (main) score 71

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:09.657617+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:02:31.245464+00:00, confidence not recorded.
  - readme: https://github.com/liam-hq/liam (fetched 2026-08-28T04:09:09.657617+00:00, sha a54aa8918a36)
  - homepage: https://liambx.com (fetched 2026-08-29T08:57:37.416760+00:00, sha bf81d3297a6d)
  - site_page: https://liambx.com/docs (fetched 2026-08-29T08:57:37.425824+00:00, sha 1c62235137e1)
  - site_page: https://liambx.com/docs/cli (fetched 2026-08-29T08:57:37.427772+00:00, sha 2ef89bf889cb)
  - site_page: https://liambx.com/docs/web (fetched 2026-08-29T08:57:37.429522+00:00, sha 55584cb5160e)
  - site_page: https://liambx.com/docs/ui-features/browsing-your-schema (fetched 2026-08-29T08:57:37.431304+00:00, sha 42d9689f5b42)
  - site_page: https://liambx.com/docs/ui-features/sharing-and-query-params (fetched 2026-08-29T08:57:37.433324+00:00, sha 7a3616994910)
  - site_page: https://liambx.com/docs/cli/ci-cd (fetched 2026-08-29T08:57:37.436005+00:00, sha e30f78e72313)
  - site_page: https://liambx.com/docs/parser/supported-formats/postgresql (fetched 2026-08-29T08:57:37.438577+00:00, sha 08b06b94952d)
  - site_page: https://liambx.com/docs/parser/supported-formats/prisma (fetched 2026-08-29T08:57:37.440639+00:00, sha 66034eba7d25)
- Data as of 2026-08-30T08:39:29.467469+00:00.