{"id":37160468,"url":"https://github.com/yarncraft/koios","last_synced_at":"2026-01-14T19:03:38.933Z","repository":{"id":118798623,"uuid":"225001942","full_name":"yarncraft/koios","owner":"yarncraft","description":"Incremental recommender engine built with Golang \u0026 Redis.","archived":false,"fork":false,"pushed_at":"2023-03-13T16:35:24.000Z","size":17,"stargazers_count":7,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-12-20T05:02:14.320Z","etag":null,"topics":["docker","echo-framework","go","golang","recommender","recommender-engine","recommender-system","redis"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yarncraft.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":"2019-11-30T11:28:21.000Z","updated_at":"2024-02-01T18:44:01.000Z","dependencies_parsed_at":null,"dependency_job_id":"deb4fb0c-7e0e-4ed2-878f-422e70aa3a27","html_url":"https://github.com/yarncraft/koios","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/yarncraft/koios","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yarncraft%2Fkoios","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yarncraft%2Fkoios/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yarncraft%2Fkoios/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yarncraft%2Fkoios/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yarncraft","download_url":"https://codeload.github.com/yarncraft/koios/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yarncraft%2Fkoios/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28431198,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T18:57:19.464Z","status":"ssl_error","status_checked_at":"2026-01-14T18:52:48.501Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["docker","echo-framework","go","golang","recommender","recommender-engine","recommender-system","redis"],"created_at":"2026-01-14T19:03:38.404Z","updated_at":"2026-01-14T19:03:38.926Z","avatar_url":"https://github.com/yarncraft.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e \u003cimg\nsrc=\"https://live.staticflickr.com/8335/8360108363_1fb50122bb_b.jpg\" width=\"200\" height=\"200\"\u003e\u003c/img\u003e\n\u003ch1\u003eKoios\u003c/h1\u003e\n\u003c/div\u003e\n\n\n### Incremental recommender engine built with Golang \u0026 Redis\n\n\u003e Koios (Coeus) was a Titan god of intelligence and farsight, meaning that, due to his inquisitive mind and desire to learn, he was with gained knowledge and understanding able to see beyond the obvious. He was also identified as a god of wisdom and heavenly oracles.\n\n### Quickstart\n\nFollowing the guidelines of the Twelve Factor App (https://12factor.net/), environment variables are kept in a dotenv file at the root directory. When using Docker, the environment (such as the API_SECRET) is configured in the Docker Compose file. Note that the final image size of **the Docker image is only 8.52MB in size** thanks to a multi-staged build and UPX stripping.\n\n````zsh\ndocker build -t koios .\ndocker tag koios:latest koios:staging\ndocker-compose up\n\ncurl -H \"Authorization: Bearer API_SECRET\" \"http://localhost:1323/api/rate?user=u1\u0026item=i1\u0026rating=0.88\"\n````\n\n### REST API Endpoints\n\n- /api/rate?user=[uid]\u0026item=[itemid]\u0026rating=[amount]\n- /api/recommend?user=[uid]\n- /api/update\n\n\n### Copyright Notice\n\nThe code was based on:\n- https://redislabs.com/docs/quick-guide-recommendations-using-redis/ \n- https://github.com/RedisLabs/redis-recommend.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyarncraft%2Fkoios","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyarncraft%2Fkoios","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyarncraft%2Fkoios/lists"}