bookwyrm/README.md

64 lines
4 KiB
Markdown
Raw Permalink Normal View History

2020-06-28 22:47:36 +00:00
# BookWyrm
2020-01-27 05:52:24 +00:00
2022-07-11 21:47:56 +00:00
[![](https://img.shields.io/github/release/bookwyrm-social/bookwyrm.svg?colorB=58839b)](https://github.com/bookwyrm-social/bookwyrm/releases)
[![Run Python Tests](https://github.com/bookwyrm-social/bookwyrm/actions/workflows/django-tests.yml/badge.svg)](https://github.com/bookwyrm-social/bookwyrm/actions/workflows/django-tests.yml)
[![Pylint](https://github.com/bookwyrm-social/bookwyrm/actions/workflows/pylint.yml/badge.svg)](https://github.com/bookwyrm-social/bookwyrm/actions/workflows/pylint.yml)
2020-01-28 02:59:49 +00:00
2022-07-11 21:47:56 +00:00
BookWyrm is a social network for tracking your reading, talking about books, writing reviews, and discovering what to read next. Federation allows BookWyrm users to join small, trusted communities that can connect with one another, and with other ActivityPub services like [Mastodon](https://joinmastodon.org/) and [Pleroma](http://pleroma.social/).
2020-02-20 22:57:23 +00:00
2021-02-13 01:29:05 +00:00
2022-07-11 21:47:56 +00:00
## Links
[![Mastodon Follow](https://img.shields.io/mastodon/follow/000146121?domain=https%3A%2F%2Ftech.lgbt&style=social)](https://tech.lgbt/@bookwyrm)
- [Project homepage](https://joinbookwyrm.com/)
- [Support](https://patreon.com/bookwyrm)
- [Documentation](https://docs.joinbookwyrm.com/)
2021-02-13 01:29:05 +00:00
## About BookWyrm
BookWyrm is a platform for social reading. You can use it to track what you're reading, review books, and follow your friends. It isn't primarily meant for cataloguing or as a data-source for books, but it does do both of those things to some degree.
2022-07-11 21:47:56 +00:00
## Federation
2021-02-08 01:11:30 +00:00
BookWyrm is built on [ActivityPub](http://activitypub.rocks/). With ActivityPub, it inter-operates with different instances of BookWyrm, and other ActivityPub compliant services, like Mastodon. This means you can run an instance for your book club, and still follow your friend who posts on a server devoted to 20th century Russian speculative fiction. It also means that your friend on mastodon can read and comment on a book review that you post on your BookWyrm instance.
2021-02-08 01:11:30 +00:00
Federation makes it possible to have small, self-determining communities, in contrast to the monolithic service you find on GoodReads or Twitter. An instance can be focused on a particular interest, be just for a group of friends, or anything else that brings people together. Each community can choose which other instances they want to federate with, and moderate and run their community autonomously. Check out https://runyourown.social/ to get a sense of the philosophy and logistics behind small, high-trust social networks.
2022-07-11 21:47:56 +00:00
## Features
2022-07-11 22:55:17 +00:00
### Post about books
2022-07-11 21:47:56 +00:00
Compose reviews, comment on what you're reading, and post quotes from books. You can converse with other BookWyrm users across the network about what they're reading.
### Track reading activity
Keep track of what books you've read, and what books you'd like to read in the future.
### Federation with ActivityPub
Federation allows you to interact with users on other instances and services, and also shares metadata about books and authors, which collaboratively builds a decentralized database of books.
### Privacy and moderation
2022-11-19 07:24:18 +00:00
Users and administrators can control who can see their posts and what other instances to federate with.
2022-07-11 21:47:56 +00:00
## Tech Stack
2021-02-13 01:29:05 +00:00
Web backend
2021-03-04 18:05:01 +00:00
- [Django](https://www.djangoproject.com/) web server
- [PostgreSQL](https://www.postgresql.org/) database
- [ActivityPub](https://activitypub.rocks/) federation
- [Celery](https://docs.celeryproject.org/) task queuing
2021-03-04 18:05:01 +00:00
- [Redis](https://redis.io/) task backend
2021-03-23 20:38:03 +00:00
- [Redis (again)](https://redis.io/) activity stream manager
2021-02-28 16:11:38 +00:00
2021-02-13 01:29:05 +00:00
Front end
2021-04-12 18:44:55 +00:00
- Django templates
- [Bulma.io](https://bulma.io/) css framework
- Vanilla JavaScript, in moderation
2021-02-28 16:11:38 +00:00
2021-02-13 01:29:05 +00:00
Deployment
2021-03-04 18:05:01 +00:00
- [Docker](https://www.docker.com/) and docker-compose
- [Gunicorn](https://gunicorn.org/) web runner
- [Flower](https://github.com/mher/flower) celery monitoring
- [Nginx](https://nginx.org/en/) HTTP server
2021-03-21 21:31:51 +00:00
## Set up BookWyrm
2022-05-15 11:01:25 +00:00
The [documentation website](https://docs.joinbookwyrm.com/) has instruction on how to set up BookWyrm in a [developer environment](https://docs.joinbookwyrm.com/install-dev.html) or [production](https://docs.joinbookwyrm.com/install-prod.html).