{"id":21593602,"url":"https://github.com/magicmark/graphql-bsky-feed","last_synced_at":"2025-10-26T07:06:04.738Z","repository":{"id":264222530,"uuid":"892429662","full_name":"magicmark/graphql-bsky-feed","owner":"magicmark","description":"🦋 GraphQL Feed for Bluesky 🦋","archived":false,"fork":false,"pushed_at":"2024-11-23T20:19:05.000Z","size":33,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-10-19T06:00:51.264Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/magicmark.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-22T05:05:36.000Z","updated_at":"2024-11-23T20:19:08.000Z","dependencies_parsed_at":"2025-03-18T10:41:09.233Z","dependency_job_id":"feb24518-8753-4b29-817d-7145408c9a6e","html_url":"https://github.com/magicmark/graphql-bsky-feed","commit_stats":null,"previous_names":["magicmark/graphql-bsky-feed"],"tags_count":0,"template":false,"template_full_name":"MarshalX/bluesky-feed-generator","purl":"pkg:github/magicmark/graphql-bsky-feed","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/magicmark%2Fgraphql-bsky-feed","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/magicmark%2Fgraphql-bsky-feed/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/magicmark%2Fgraphql-bsky-feed/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/magicmark%2Fgraphql-bsky-feed/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/magicmark","download_url":"https://codeload.github.com/magicmark/graphql-bsky-feed/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/magicmark%2Fgraphql-bsky-feed/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":281069675,"owners_count":26438675,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-26T02:00:06.575Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-24T17:13:39.536Z","updated_at":"2025-10-26T07:06:04.699Z","avatar_url":"https://github.com/magicmark.png","language":"Python","readme":"## ATProto Feed Generator powered by [The AT Protocol SDK for Python](https://github.com/MarshalX/atproto)\n\n\u003e Feed Generators are services that provide custom algorithms to users through the AT Protocol.\n\nOfficial overview (read it first): https://github.com/bluesky-social/feed-generator#overview\n\n### Getting Started\n\nWe've set up this simple server with SQLite to store and query data. Feel free to switch this out for whichever database you prefer.\n\nNext, you will need to do two things:\n1. Implement indexing logic in `server/data_filter.py`.\n2. Implement feed generation logic in `server/algos`.\n\nWe've taken care of setting this server up with a did:web. However, you're free to switch this out for did:plc if you like - you may want to if you expect this Feed Generator to be long-standing and possibly migrating domains.\n\n### Publishing your feed\n\nTo publish your feed, go to the script at `publish_feed.py` and fill in the variables at the top. Examples are included, and some are optional. To publish your feed generator, simply run `python publish_feed.py`.\n\nTo update your feed's display data (name, avatar, description, etc.), just update the relevant variables and re-run the script.\n\nAfter successfully running the script, you should be able to see your feed from within the app, as well as share it by embedding a link in a post (similar to a quote post).\n\n### Running the Server\n\nInstall Python 3.7+, optionally create virtual environment.\n\nInstall dependencies:\n```shell\npip install -r requirements.txt\n```\n\nCopy `.env.example` as `.env`. Fill the variables.\n\n\u003e **Note**\n\u003e To get value for \"GRAPHQL_URI\" you should publish the feed first. \n\nRun development flask server:\n```shell\nflask run\n```\n\nRun development server with debug:\n```shell\nflask --debug run\n```\n\u003e **Note**\n\u003e Duplication of data stream instances in debug mode is fine. \n\u003e Read warn below.\n\n\u003e **Warning**\n\u003e In production, you should use production WSGI server instead.\n\n\u003e **Warning**\n\u003e If you want to run server in many workers, you should run Data Stream (Firehose) separately.\n\nEndpoints:\n- /.well-known/did.json\n- /xrpc/app.bsky.feed.describeFeedGenerator\n- /xrpc/app.bsky.feed.getFeedSkeleton\n\n### License\n\nMIT\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmagicmark%2Fgraphql-bsky-feed","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmagicmark%2Fgraphql-bsky-feed","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmagicmark%2Fgraphql-bsky-feed/lists"}