# bookwyrm-social/bookwyrm

Social reading and reviewing, decentralized with ActivityPub

Repository: https://github.com/bookwyrm-social/bookwyrm
Canonical: https://ross.abutalabs.com/products/bookwyrm
Homepage: http://joinbookwyrm.com/
Language: Python
License: NOASSERTION
License Family: other
Topics: activitypub, decentralization, federation, books, reading, social-media, openlibrary, bookwyrm
Last push: 2026-08-24T05:02:44+00:00

## Health v2 (maintenance only)
Score: 93/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 81, longevity 100
- inputs: {"age_days": 2410, "days_push": 9, "days_rel": 44, "gap_med": 48.5, "n_releases_24m": 7}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2773, forks 329 (observed 2026-08-28T04:07:19.079087+00:00)

## What it is
BookWyrm is a self-hostable, decentralized social network for tracking reading, writing book reviews, and discovering books, built on the ActivityPub federation protocol. It lets communities run their own instances that interoperate with other BookWyrm instances and ActivityPub services like Mastodon and Pleroma.

## Use cases
- track books i'm reading and set reading goals
- self-host a goodreads alternative for my book club
- write and share book reviews on the fediverse
- run a federated book community that connects with mastodon
- create shared reading lists with friends
- follow friends' reading activity across instances

## When to choose
- you want a decentralized, community-run alternative to GoodReads
- you need ActivityPub federation with Mastodon and other fediverse services
- you want to host a small, trusted reading community with granular privacy controls
- you value human-curated book recommendations over algorithmic ones

## When to avoid
- you need a centralized service with a large existing user base
- you primarily want a book metadata catalog or data source rather than a social network
- you need a mobile-first native app experience
- you cannot operate a Python/Django web server instance

## Facets
- artifact type: application
- maturity: active
- function: web-framework, self-hosted, search-engine
- domain: social-media, web-development, self-hosted
- platform: python, self-hosted
- tags: activitypub, fediverse, social-reading, book-tracking, federation, goodreads-alternative, mastodon, books, web-server, docker

## Member repositories
- bookwyrm-social/bookwyrm (main) score 93

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:19.079087+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-30T08:16:36.117015+00:00, confidence not recorded.
  - readme: https://github.com/bookwyrm-social/bookwyrm (fetched 2026-08-28T04:07:19.079087+00:00, sha da88948cf2f2)
  - homepage: http://joinbookwyrm.com/ (fetched 2026-08-29T09:56:04.031204+00:00, sha 184287296939)
  - site_page: https://docs.joinbookwyrm.com/ (fetched 2026-08-29T09:56:04.040773+00:00, sha ae32114c4b35)
  - site_page: https://docs.joinbookwyrm.com (fetched 2026-08-29T09:56:04.043291+00:00, sha ae32114c4b35)
- Data as of 2026-08-30T08:39:29.467469+00:00.
