{"adoption": {"forks": 96, "observed_at": "2026-08-28T04:04:48.198301+00:00", "stars": 1465}, "canonical_url": "https://ross.abutalabs.com/products/spqr", "card": {"archived": false, "artifact_type": "service", "description": "Stateless Postgres Query Router.", "domain": ["databases", "microservices", "backend", "self-hosted"], "enriched": true, "function": ["database", "routing", "proxy", "middleware"], "health_score": 99, "homepage": "https://pg-sharding.tech", "language": "Go", "license": "NOASSERTION", "license_family": "other", "maturity": "active", "member_repos": ["pg-sharding/spqr"], "name": "pg-sharding/spqr", "platform": ["go", "self-hosted", "cloud"], "pushed_at": "2026-08-26T19:08:20+00:00", "repo": "pg-sharding/spqr", "stars": 1465, "tags": ["postgresql", "sharding", "query-router", "oltp", "connection-pooling", "horizontal-scaling", "database-proxy", "linux", "docker"], "topics": ["go", "postgresql", "sharding", "pooler", "proxy", "postgres"], "urls": [], "use_cases": ["shard a large postgres database horizontally", "route queries to postgres shards without app-level sharding logic", "migrate a monolithic postgres database to a sharded setup", "scale postgres beyond terabytes of data and 100k queries per second", "automate resharding of an already sharded postgres cluster", "use managed postgres services like AWS RDS as shards behind a router"], "what_it_is": "SPQR (Stateless Postgres Query Router) is a production-ready proxy that horizontally scales PostgreSQL via sharding by routing queries to the correct shard at the PostgreSQL protocol level. It is written in Go, stores sharding rules in etcd, and is battle-tested at Yandex Cloud for OLTP workloads.", "when_to_avoid": ["you need cross-shard JOINs or multi-shard transactions", "your workload is OLAP or analytical — use Greenplum or similar instead", "your dataset is small enough to fit comfortably on a single instance"], "when_to_choose": ["your data exceeds several TB or vertical scaling has hit its limits", "workload is mostly single-shard OLTP queries with a clear sharding key", "you want a permissively licensed (PostgreSQL license) alternative to Citus or Vitess", "you want to keep using vanilla PostgreSQL instead of another database engine"]}, "data_as_of": "2026-08-30T08:39:29.467469+00:00", "members": [{"path": "/products/spqr", "repo": "pg-sharding/spqr", "role": "main", "score": 92}], "provenance": {"archived": {"kind": "observed", "observed_at": "2026-08-28T04:04:48.198301+00:00", "source": "github"}, "artifact_type": {"confidence": null, "enriched_at": "2026-08-30T04:35:06.612538+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "c2afbda7820e6943decbc39460abd59cc71b8f16aafd7aadd72e2fdcd16cceed", "fetched_at": "2026-08-28T04:04:48.198301+00:00", "kind": "readme", "missing": false, "url": "https://github.com/pg-sharding/spqr"}, {"content_hash": "b352981ef142b5b2d84bc97f48af17246397816357b9ea7db1ea2a0dc16bb915", "fetched_at": "2026-08-29T11:43:31.659288+00:00", "kind": "homepage", "missing": false, "url": "https://pg-sharding.tech"}, {"content_hash": "31fa82ed5cade64876695890f8fd34c5f5b0c973e6d0b92bd7c37cb5ef98b3c0", "fetched_at": "2026-08-29T11:43:31.668536+00:00", "kind": "site_page", "missing": false, "url": "https://docs.pg-sharding.tech/welcome/faq"}, {"content_hash": "e12a8043e9db6b1e478f469fcd4b31a1386ec546a5f9782e7af9cdf02df988ff", "fetched_at": "2026-08-29T11:43:31.670686+00:00", "kind": "site_page", "missing": false, "url": "https://docs.pg-sharding.tech"}, {"content_hash": "f58f15a9c3718ee6ed31c48b8c3b1972ef8b8b26c52646c5942507f0baf9c350", "fetched_at": "2026-08-29T11:43:31.673283+00:00", "kind": "site_page", "missing": false, "url": "https://docs.pg-sharding.tech/welcome/get_started"}], "taxonomy_version": 1}, "description": {"kind": "observed", "observed_at": "2026-08-28T04:04:48.198301+00:00", "source": "github"}, "domain": {"confidence": null, "enriched_at": "2026-08-30T04:35:06.612538+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "c2afbda7820e6943decbc39460abd59cc71b8f16aafd7aadd72e2fdcd16cceed", "fetched_at": "2026-08-28T04:04:48.198301+00:00", "kind": "readme", "missing": false, "url": "https://github.com/pg-sharding/spqr"}, {"content_hash": "b352981ef142b5b2d84bc97f48af17246397816357b9ea7db1ea2a0dc16bb915", "fetched_at": "2026-08-29T11:43:31.659288+00:00", "kind": "homepage", "missing": false, "url": "https://pg-sharding.tech"}, {"content_hash": "31fa82ed5cade64876695890f8fd34c5f5b0c973e6d0b92bd7c37cb5ef98b3c0", "fetched_at": "2026-08-29T11:43:31.668536+00:00", "kind": "site_page", "missing": false, "url": "https://docs.pg-sharding.tech/welcome/faq"}, {"content_hash": "e12a8043e9db6b1e478f469fcd4b31a1386ec546a5f9782e7af9cdf02df988ff", "fetched_at": "2026-08-29T11:43:31.670686+00:00", "kind": "site_page", "missing": false, "url": "https://docs.pg-sharding.tech"}, {"content_hash": "f58f15a9c3718ee6ed31c48b8c3b1972ef8b8b26c52646c5942507f0baf9c350", "fetched_at": "2026-08-29T11:43:31.673283+00:00", "kind": "site_page", "missing": false, "url": "https://docs.pg-sharding.tech/welcome/get_started"}], "taxonomy_version": 1}, "enriched": {"inputs": [], "kind": "computed", "method": "enrichment_status"}, "function": {"confidence": null, "enriched_at": "2026-08-30T04:35:06.612538+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "c2afbda7820e6943decbc39460abd59cc71b8f16aafd7aadd72e2fdcd16cceed", "fetched_at": "2026-08-28T04:04:48.198301+00:00", "kind": "readme", "missing": false, "url": "https://github.com/pg-sharding/spqr"}, {"content_hash": "b352981ef142b5b2d84bc97f48af17246397816357b9ea7db1ea2a0dc16bb915", "fetched_at": "2026-08-29T11:43:31.659288+00:00", "kind": "homepage", "missing": false, "url": "https://pg-sharding.tech"}, {"content_hash": "31fa82ed5cade64876695890f8fd34c5f5b0c973e6d0b92bd7c37cb5ef98b3c0", "fetched_at": "2026-08-29T11:43:31.668536+00:00", "kind": "site_page", "missing": false, "url": "https://docs.pg-sharding.tech/welcome/faq"}, {"content_hash": "e12a8043e9db6b1e478f469fcd4b31a1386ec546a5f9782e7af9cdf02df988ff", "fetched_at": "2026-08-29T11:43:31.670686+00:00", "kind": "site_page", "missing": false, "url": "https://docs.pg-sharding.tech"}, {"content_hash": "f58f15a9c3718ee6ed31c48b8c3b1972ef8b8b26c52646c5942507f0baf9c350", "fetched_at": "2026-08-29T11:43:31.673283+00:00", "kind": "site_page", "missing": false, "url": "https://docs.pg-sharding.tech/welcome/get_started"}], "taxonomy_version": 1}, "health_score": {"inputs": ["days_since_push", "days_since_release", "archived"], "kind": "computed", "method": "health_v1"}, "homepage": {"kind": "observed", "observed_at": "2026-08-28T04:04:48.198301+00:00", "source": "github"}, "language": {"kind": "observed", "observed_at": "2026-08-28T04:04:48.198301+00:00", "source": "github"}, "license": {"kind": "observed", "observed_at": "2026-08-28T04:04:48.198301+00:00", "source": "github"}, "license_family": {"inputs": ["license"], "kind": "computed", "method": "license_family"}, "maturity": {"confidence": null, "enriched_at": "2026-08-30T04:35:06.612538+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "c2afbda7820e6943decbc39460abd59cc71b8f16aafd7aadd72e2fdcd16cceed", "fetched_at": "2026-08-28T04:04:48.198301+00:00", "kind": "readme", "missing": false, "url": "https://github.com/pg-sharding/spqr"}, {"content_hash": "b352981ef142b5b2d84bc97f48af17246397816357b9ea7db1ea2a0dc16bb915", "fetched_at": "2026-08-29T11:43:31.659288+00:00", "kind": "homepage", "missing": false, "url": "https://pg-sharding.tech"}, {"content_hash": "31fa82ed5cade64876695890f8fd34c5f5b0c973e6d0b92bd7c37cb5ef98b3c0", "fetched_at": "2026-08-29T11:43:31.668536+00:00", "kind": "site_page", "missing": false, "url": "https://docs.pg-sharding.tech/welcome/faq"}, {"content_hash": "e12a8043e9db6b1e478f469fcd4b31a1386ec546a5f9782e7af9cdf02df988ff", "fetched_at": "2026-08-29T11:43:31.670686+00:00", "kind": "site_page", "missing": false, "url": "https://docs.pg-sharding.tech"}, {"content_hash": "f58f15a9c3718ee6ed31c48b8c3b1972ef8b8b26c52646c5942507f0baf9c350", "fetched_at": "2026-08-29T11:43:31.673283+00:00", "kind": "site_page", "missing": false, "url": "https://docs.pg-sharding.tech/welcome/get_started"}], "taxonomy_version": 1}, "member_repos": {"kind": "observed", "observed_at": "2026-08-28T04:04:48.198301+00:00", "source": "github"}, "name": {"kind": "observed", "observed_at": "2026-08-28T04:04:48.198301+00:00", "source": "github"}, "platform": {"confidence": null, "enriched_at": "2026-08-30T04:35:06.612538+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "c2afbda7820e6943decbc39460abd59cc71b8f16aafd7aadd72e2fdcd16cceed", "fetched_at": "2026-08-28T04:04:48.198301+00:00", "kind": "readme", "missing": false, "url": "https://github.com/pg-sharding/spqr"}, {"content_hash": "b352981ef142b5b2d84bc97f48af17246397816357b9ea7db1ea2a0dc16bb915", "fetched_at": "2026-08-29T11:43:31.659288+00:00", "kind": "homepage", "missing": false, "url": "https://pg-sharding.tech"}, {"content_hash": "31fa82ed5cade64876695890f8fd34c5f5b0c973e6d0b92bd7c37cb5ef98b3c0", "fetched_at": "2026-08-29T11:43:31.668536+00:00", "kind": "site_page", "missing": false, "url": "https://docs.pg-sharding.tech/welcome/faq"}, {"content_hash": "e12a8043e9db6b1e478f469fcd4b31a1386ec546a5f9782e7af9cdf02df988ff", "fetched_at": "2026-08-29T11:43:31.670686+00:00", "kind": "site_page", "missing": false, "url": "https://docs.pg-sharding.tech"}, {"content_hash": "f58f15a9c3718ee6ed31c48b8c3b1972ef8b8b26c52646c5942507f0baf9c350", "fetched_at": "2026-08-29T11:43:31.673283+00:00", "kind": "site_page", "missing": false, "url": "https://docs.pg-sharding.tech/welcome/get_started"}], "taxonomy_version": 1}, "pushed_at": {"kind": "observed", "observed_at": "2026-08-28T04:04:48.198301+00:00", "source": "github"}, "repo": {"kind": "observed", "observed_at": "2026-08-28T04:04:48.198301+00:00", "source": "github"}, "stars": {"kind": "observed", "observed_at": "2026-08-28T04:04:48.198301+00:00", "source": "github"}, "tags": {"confidence": null, "enriched_at": "2026-08-30T04:35:06.612538+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "c2afbda7820e6943decbc39460abd59cc71b8f16aafd7aadd72e2fdcd16cceed", "fetched_at": "2026-08-28T04:04:48.198301+00:00", "kind": "readme", "missing": false, "url": "https://github.com/pg-sharding/spqr"}, {"content_hash": "b352981ef142b5b2d84bc97f48af17246397816357b9ea7db1ea2a0dc16bb915", "fetched_at": "2026-08-29T11:43:31.659288+00:00", "kind": "homepage", "missing": false, "url": "https://pg-sharding.tech"}, {"content_hash": "31fa82ed5cade64876695890f8fd34c5f5b0c973e6d0b92bd7c37cb5ef98b3c0", "fetched_at": "2026-08-29T11:43:31.668536+00:00", "kind": "site_page", "missing": false, "url": "https://docs.pg-sharding.tech/welcome/faq"}, {"content_hash": "e12a8043e9db6b1e478f469fcd4b31a1386ec546a5f9782e7af9cdf02df988ff", "fetched_at": "2026-08-29T11:43:31.670686+00:00", "kind": "site_page", "missing": false, "url": "https://docs.pg-sharding.tech"}, {"content_hash": "f58f15a9c3718ee6ed31c48b8c3b1972ef8b8b26c52646c5942507f0baf9c350", "fetched_at": "2026-08-29T11:43:31.673283+00:00", "kind": "site_page", "missing": false, "url": "https://docs.pg-sharding.tech/welcome/get_started"}], "taxonomy_version": 1}, "topics": {"kind": "observed", "observed_at": "2026-08-28T04:04:48.198301+00:00", "source": "github"}, "urls": {"kind": "observed", "observed_at": "2026-08-28T04:04:48.198301+00:00", "source": "github"}, "use_cases": {"confidence": null, "enriched_at": "2026-08-30T04:35:06.612538+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "c2afbda7820e6943decbc39460abd59cc71b8f16aafd7aadd72e2fdcd16cceed", "fetched_at": "2026-08-28T04:04:48.198301+00:00", "kind": "readme", "missing": false, "url": "https://github.com/pg-sharding/spqr"}, {"content_hash": "b352981ef142b5b2d84bc97f48af17246397816357b9ea7db1ea2a0dc16bb915", "fetched_at": "2026-08-29T11:43:31.659288+00:00", "kind": "homepage", "missing": false, "url": "https://pg-sharding.tech"}, {"content_hash": "31fa82ed5cade64876695890f8fd34c5f5b0c973e6d0b92bd7c37cb5ef98b3c0", "fetched_at": "2026-08-29T11:43:31.668536+00:00", "kind": "site_page", "missing": false, "url": "https://docs.pg-sharding.tech/welcome/faq"}, {"content_hash": "e12a8043e9db6b1e478f469fcd4b31a1386ec546a5f9782e7af9cdf02df988ff", "fetched_at": "2026-08-29T11:43:31.670686+00:00", "kind": "site_page", "missing": false, "url": "https://docs.pg-sharding.tech"}, {"content_hash": "f58f15a9c3718ee6ed31c48b8c3b1972ef8b8b26c52646c5942507f0baf9c350", "fetched_at": "2026-08-29T11:43:31.673283+00:00", "kind": "site_page", "missing": false, "url": "https://docs.pg-sharding.tech/welcome/get_started"}], "taxonomy_version": 1}, "what_it_is": {"confidence": null, "enriched_at": "2026-08-30T04:35:06.612538+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "c2afbda7820e6943decbc39460abd59cc71b8f16aafd7aadd72e2fdcd16cceed", "fetched_at": "2026-08-28T04:04:48.198301+00:00", "kind": "readme", "missing": false, "url": "https://github.com/pg-sharding/spqr"}, {"content_hash": "b352981ef142b5b2d84bc97f48af17246397816357b9ea7db1ea2a0dc16bb915", "fetched_at": "2026-08-29T11:43:31.659288+00:00", "kind": "homepage", "missing": false, "url": "https://pg-sharding.tech"}, {"content_hash": "31fa82ed5cade64876695890f8fd34c5f5b0c973e6d0b92bd7c37cb5ef98b3c0", "fetched_at": "2026-08-29T11:43:31.668536+00:00", "kind": "site_page", "missing": false, "url": "https://docs.pg-sharding.tech/welcome/faq"}, {"content_hash": "e12a8043e9db6b1e478f469fcd4b31a1386ec546a5f9782e7af9cdf02df988ff", "fetched_at": "2026-08-29T11:43:31.670686+00:00", "kind": "site_page", "missing": false, "url": "https://docs.pg-sharding.tech"}, {"content_hash": "f58f15a9c3718ee6ed31c48b8c3b1972ef8b8b26c52646c5942507f0baf9c350", "fetched_at": "2026-08-29T11:43:31.673283+00:00", "kind": "site_page", "missing": false, "url": "https://docs.pg-sharding.tech/welcome/get_started"}], "taxonomy_version": 1}, "when_to_avoid": {"confidence": null, "enriched_at": "2026-08-30T04:35:06.612538+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "c2afbda7820e6943decbc39460abd59cc71b8f16aafd7aadd72e2fdcd16cceed", "fetched_at": "2026-08-28T04:04:48.198301+00:00", "kind": "readme", "missing": false, "url": "https://github.com/pg-sharding/spqr"}, {"content_hash": "b352981ef142b5b2d84bc97f48af17246397816357b9ea7db1ea2a0dc16bb915", "fetched_at": "2026-08-29T11:43:31.659288+00:00", "kind": "homepage", "missing": false, "url": "https://pg-sharding.tech"}, {"content_hash": "31fa82ed5cade64876695890f8fd34c5f5b0c973e6d0b92bd7c37cb5ef98b3c0", "fetched_at": "2026-08-29T11:43:31.668536+00:00", "kind": "site_page", "missing": false, "url": "https://docs.pg-sharding.tech/welcome/faq"}, {"content_hash": "e12a8043e9db6b1e478f469fcd4b31a1386ec546a5f9782e7af9cdf02df988ff", "fetched_at": "2026-08-29T11:43:31.670686+00:00", "kind": "site_page", "missing": false, "url": "https://docs.pg-sharding.tech"}, {"content_hash": "f58f15a9c3718ee6ed31c48b8c3b1972ef8b8b26c52646c5942507f0baf9c350", "fetched_at": "2026-08-29T11:43:31.673283+00:00", "kind": "site_page", "missing": false, "url": "https://docs.pg-sharding.tech/welcome/get_started"}], "taxonomy_version": 1}, "when_to_choose": {"confidence": null, "enriched_at": "2026-08-30T04:35:06.612538+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "c2afbda7820e6943decbc39460abd59cc71b8f16aafd7aadd72e2fdcd16cceed", "fetched_at": "2026-08-28T04:04:48.198301+00:00", "kind": "readme", "missing": false, "url": "https://github.com/pg-sharding/spqr"}, {"content_hash": "b352981ef142b5b2d84bc97f48af17246397816357b9ea7db1ea2a0dc16bb915", "fetched_at": "2026-08-29T11:43:31.659288+00:00", "kind": "homepage", "missing": false, "url": "https://pg-sharding.tech"}, {"content_hash": "31fa82ed5cade64876695890f8fd34c5f5b0c973e6d0b92bd7c37cb5ef98b3c0", "fetched_at": "2026-08-29T11:43:31.668536+00:00", "kind": "site_page", "missing": false, "url": "https://docs.pg-sharding.tech/welcome/faq"}, {"content_hash": "e12a8043e9db6b1e478f469fcd4b31a1386ec546a5f9782e7af9cdf02df988ff", "fetched_at": "2026-08-29T11:43:31.670686+00:00", "kind": "site_page", "missing": false, "url": "https://docs.pg-sharding.tech"}, {"content_hash": "f58f15a9c3718ee6ed31c48b8c3b1972ef8b8b26c52646c5942507f0baf9c350", "fetched_at": "2026-08-29T11:43:31.673283+00:00", "kind": "site_page", "missing": false, "url": "https://docs.pg-sharding.tech/welcome/get_started"}], "taxonomy_version": 1}}, "score": {"components": {"activity": 99, "longevity": 100, "rhythm": 77}, "computed_at": "2026-09-03T02:20:16.233290+00:00", "flags": ["no_license"], "formula": "round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)", "inputs": {"age_days": 1839, "days_push": 7, "days_rel": 75, "gap_med": 47, "n_releases_24m": 12}, "score": 92, "version": 2}, "staleness": {"enrichment_outdated": false, "low_confidence": false, "scrape_days": 9, "stale_scrape": false}}