Got an IndieWeb site? Want to interact with federated social networks like Mastodon, Hubzilla, and more? Bridgy Fed is for you.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
Go to file
Ryan Barrett b739bd4cee
return 404 on requests for unknown users instead of automatically creating them
15 hours ago
.circleci bridgy-at: add lexrpc dep, install atproto lexicons on circle 4 weeks ago
.github dependabot auto-merge workflow: message when we skip major versions 10 months ago
scripts migrate_activity_to_object: resume from latest_updated 3 days ago
static user page activities: show counts of delivered, failed, undelivered 1 day ago
templates user page activities: show counts of delivered, failed, undelivered 1 day ago
tests return 404 on requests for unknown users instead of automatically creating them 15 hours ago
.gcloudignore webmention => AP: handle multiple in-reply-to links 3 years ago
.gitignore more app/repo scaffolding 2 months ago
README.md update fediverse app compatibility, move from readme to docs 3 weeks ago
activitypub.py return 404 on requests for unknown users instead of automatically creating them 15 hours ago
add_webmention.py cache 502s and 504s for requests that fetch users' sites 2 weeks ago
app.py flask app: suppress some lexprc and negotiator logging 3 weeks ago
app.yaml bump pending latency down to 500ms, threads up to 30, for link preview DOSes 2 weeks ago
appengine_config.py unify request handler classes and handle_exception; move away from HOST[_URL] 3 years ago
common.py return 404 on requests for unknown users instead of automatically creating them 15 hours ago
config.py cache more aggressively: bump expiration up to 60s, threshold to 3k 2 weeks ago
follow.py add more logging for when we write Objects 1 day ago
index.yaml Activity => Object: user dashboard UI bug fixes, add missing Object index 4 days ago
indieauth_client_id add follow UI to user/[domain]/following 1 month ago
lexicons add XRPC server and method skeletons 2 months ago
models.py return 404 on requests for unknown users instead of automatically creating them 15 hours ago
oauth_dropins_fonts lots of UI tweaks 3 months ago
oauth_dropins_static switch oauth_dropins symlink to oauth_dropins_static, drop it from repo 2 years ago
pages.py add nodeinfo 20 hours ago
redirect.py cache 502s and 504s for requests that fetch users' sites 2 weeks ago
render.py Activity => Object: temporarily disable inner object rendering 3 days ago
requirements.txt build(deps): bump websocket-client from 1.5.0 to 1.5.1 20 hours ago
superfeedr.py logging: use separate loggers for each module with their names 1 year ago
webfinger.py remove OStatus parts of Webfinger 2 weeks ago
webmention.py return 404 on requests for unknown users instead of automatically creating them 15 hours ago
xrpc_actor.py bluesky: misc minor XPRC error handling 4 weeks ago
xrpc_feed.py Activity => Object: update xrpc_feed.py 4 days ago
xrpc_graph.py add new common.fetch_followers() fn, use in UI, AP collections, and XRPCs 3 weeks ago

README.md

Bridgy Fed Circle CI Coverage Status

Bridgy Fed connects your web site to Mastodon and the fediverse via ActivityPub, webmentions, and microformats2. Your site gets its own fediverse profile, posts and avatar and header and all. Bridgy Fed translates likes, reposts, mentions, follows, and more back and forth. See the user docs for more details.

https://fed.brid.gy/

Also see the original design blog posts.

License: This project is placed in the public domain.

Development

Pull requests are welcome! Feel free to ping me in #indieweb-dev with any questions.

First, fork and clone this repo. Then, install the Google Cloud SDK and run gcloud components install beta cloud-datastore-emulator to install the datastore emulator. Once you have them, set up your environment by running these commands in the repo root directory:

gcloud config set project bridgy-federated
python3 -m venv local
source local/bin/activate
pip install -r requirements.txt

Now, run the tests to check that everything is set up ok:

gcloud beta emulators datastore start --use-firestore-in-datastore-mode --no-store-on-disk --host-port=localhost:8089 --quiet < /dev/null >& /dev/null &
python3 -m unittest discover

Finally, run this in the repo root directory to start the web app locally:

GAE_ENV=localdev FLASK_ENV=development flask run -p 8080

If you send a pull request, please include (or update) a test for the new functionality!

If you hit an error during setup, check out the oauth-dropins Troubleshooting/FAQ section. For searchability, here are a handful of error messages that have solutions there:

bash: ./bin/easy_install: ...bad interpreter: No such file or directory

ImportError: cannot import name certs

ImportError: No module named dev_appserver

ImportError: cannot import name tweepy

File ".../site-packages/tweepy/auth.py", line 68, in _get_request_token
  raise TweepError(e)
TweepError: must be _socket.socket, not socket

error: option --home not recognized

You may need to change granary, oauth-dropins, mf2util, or other dependencies as well as as Bridgy Fed. To do that, clone their repo locally, then install them in "source" mode with e.g.:

pip uninstall -y granary
pip install -e <path to granary>

To deploy to the production instance on App Engine - if @snarfed has added you as an owner - run:

gcloud -q beta app deploy --no-cache --project bridgy-federated *.yaml

Stats

I occasionally generate stats and graphs of usage and growth via BigQuery, like I do with Bridgy. Here's how.

  1. Export the full datastore to Google Cloud Storage. Include all entities except MagicKey. Check to see if any new kinds have been added since the last time this command was run.

    gcloud datastore export --async gs://bridgy-federated.appspot.com/stats/ --kinds Follower,Response
    

    Note that --kinds is required. From the export docs:

    Data exported without specifying an entity filter cannot be loaded into BigQuery.

  2. Wait for it to be done with gcloud datastore operations list | grep done.

  3. Import it into BigQuery:

    for kind in Follower Response; do
      bq load --replace --nosync --source_format=DATASTORE_BACKUP datastore.$kind gs://bridgy-federated.appspot.com/stats/all_namespaces/kind_$kind/all_namespaces_kind_$kind.export_metadata
    done
    
  4. Check the jobs with bq ls -j, then wait for them with bq wait.

  5. Run the full stats BigQuery query. Download the results as CSV.

  6. Open the stats spreadsheet. Import the CSV, replacing the data sheet.

  7. Check out the graphs! Save full size images with OS or browser screenshots, thumbnails with the Download Chart button.