Skip to content

yinan-c/RSS-GPT

Repository files navigation

RSS-GPT

If you need a web GUI to manage feeds better, check out my latest project: RSSBrew, a self-hosted RSS-GPT alternative with more features and customizability, built with Django.

What is this?

Configuration Guide | 中文简介 | 中文教程

Using GitHub Actions to run a simple Python script repeatedly: Calling OpenAI API to generate summaries for RSS feeds, and push the generated feeds to GitHub Pages. Easy to configure, no server needed.

Features

  • Use ChatGPT to summarize RSS feeds, and attach summaries to the original articles, support custom summary length and target language.
  • Aggregate multiple RSS feeds into one, remove duplicate articles, subscribe with a single address.
  • Add filters to your own personalized RSS feeds.
  • Host your own RSS feeds on GitHub repo and GitHub Pages.

Quick configuration guide

  • Fork this repo
  • Add Repository Secrets
    • U_NAME: your GitHub username
    • U_EMAIL: your GitHub email
    • WORK_TOKEN: your GitHub personal access token with repo and workflow scope, get it from GitHub settings
    • OPENAI_API_KEY(OPTIONAL, only needed when using AI summarization feature): Get it from OpenAI website
  • Enable GitHub Pages in repo settings, choose deploy from branch, and set the directory to /docs.
  • Configure your RSS feeds in config.ini

You can check out here for a more detailed configuration guide.

ChangeLog and updates

  • As OpenAI released a new version of openai package on Nov 06, 2023. More powerful models are coming, the way to call API also changed. As a result, the old script will no longer work with the latest version installed, and needs to be updated. Otherwise, you will have to set openai==0.27.8 in requirements.txt to use the old version.
  • Check out the CHANGELOG.md.

Contributions are welcome!

  • Feel free to submit issues and pull requests.

Support this project

  • If you find it helpful, please star this repo. Please also consider buying me a coffee to help maintain this project and cover the expenses of OpenAI API while hosting the feeds. I appreciate your support.

Buy Me A Coffee

Example feeds being processed

These feeds on hosted in the docs/ subdirectory in this repo as well as on my GitHub Pages. Feel free to subscribe in your favorite RSS reader.

I will consider hosting more feeds in the future. Email me or submit an issue if there are any questions using the script or any suggestions.

About

Using ChatGPT to summarize your personalized RSS feeds

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published