{"id":13819000,"url":"https://github.com/bdavi/polynews","last_synced_at":"2025-05-16T04:32:03.848Z","repository":{"id":55431918,"uuid":"312425248","full_name":"bdavi/polynews","owner":"bdavi","description":null,"archived":false,"fork":false,"pushed_at":"2022-08-12T03:22:56.000Z","size":477,"stargazers_count":7,"open_issues_count":0,"forks_count":6,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-11-19T18:45:22.571Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://polynews.co","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bdavi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-11-12T23:57:18.000Z","updated_at":"2023-09-28T13:02:49.000Z","dependencies_parsed_at":"2022-08-15T00:10:39.172Z","dependency_job_id":null,"html_url":"https://github.com/bdavi/polynews","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bdavi%2Fpolynews","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bdavi%2Fpolynews/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bdavi%2Fpolynews/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bdavi%2Fpolynews/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bdavi","download_url":"https://codeload.github.com/bdavi/polynews/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254469142,"owners_count":22076440,"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","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-08-04T08:00:37.295Z","updated_at":"2025-05-16T04:32:03.379Z","avatar_url":"https://github.com/bdavi.png","language":"Ruby","funding_links":[],"categories":["Happy Exploring 🤘"],"sub_categories":[],"readme":"![](logo.png)\n\nAI enhanced news aggregation.\n\n\n## Technical summary\nPOLYNews provides an integrated approach to reading news from a variety of\nsources.\n\nArticles are retrieved via public RSS and grouped by story using a TF-IDF BOW\nmodel. The most important news of the day is inferred by how extensively a\nstory is covered across multiple sources.\n\n\n## Requirements\n- Postgres 12\n- Ruby 2.6\n- Node 14\n- Yarn 1.22\n- Heroku CLI\n\n\n## Roadmap\n- Track article popularity and integrate that into the headline/most important logic.\n- Switch to a n-gram model to improve story grouping\n- Customized user recommendations using past viewing history to train the model.\n- Expand categories and sources to provide more granular and in depth coverage.\n- Switch to a magazine-like UI which emphasizes article importance\n\n\n## Application setup\nPrepare the application for local execution with:\n```\n\u003e bin/setup\n```\n\nAmong other things, this will:\n- Setup the heroku remote\n- Install Ruby and JS dependencies\n- Create, migrate and seed the database\n- Download and group the first batch of news articles\n- Run the specs and lint the application\n\n\n## Code Verification\nPOLYNews uses a variety of tools to maintain code correctness, consistency\nand quality. Before merging new code the expectation is:\n- All specs pass (rspec)\n- 90% test coverage (simplecov)\n- Adherence to the style guide (no rubocop offenses / specifically disable where necessary)\n- Minimum 90% quality score on all code files (rubycritic)\n\nTo verify the application run:\n```\n\u003e bin/verify\n```\n\n\n## Run the application\nRun the following:\n```\n\u003e bin/rails server\n```\n\nApplication is available at `localhost:3000`.\n\nThe root and `/news` routes provide the public interface for the application.\n\nAdmin routes are accessible at `/channels`. In production, the admin routes are\nprotected with HTTP Basic Authorization. Set the `ADMIN_USERNAME` and\n`ADMIN_PASSWORD` environment variables to specify admin credentials.\n\nThe admin routes are useful for troubleshooting, but generally changes should be\nmade via the db seeds.\n\n\n## Configuring and updating the news sources\nThe `news:update` rake task is provided for refreshing the current news articles.\n\nThe `news:full_refresh` rake task will completely refresh the news by emptying \nthe db, reseeding and then downloading articles from scratch. This is particularly\nhelpful when large scale changes are made to the channels.\n\n\n## Production\nPOLYNews is available online at [polynews.co](http://polynews.co)\n\n(Initial load may take a moment for the Heroku dyno to spin up)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbdavi%2Fpolynews","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbdavi%2Fpolynews","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbdavi%2Fpolynews/lists"}