{"id":46968501,"url":"https://github.com/nielsole/kudos","last_synced_at":"2026-03-11T11:39:24.391Z","repository":{"id":64304415,"uuid":"72783212","full_name":"nielsole/kudos","owner":"nielsole","description":"A fast, simple and self-hosted like button","archived":false,"fork":false,"pushed_at":"2024-06-19T17:09:47.000Z","size":89,"stargazers_count":15,"open_issues_count":0,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-17T07:51:55.536Z","etag":null,"topics":["blogging","like-button"],"latest_commit_sha":null,"homepage":"","language":"Go","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/nielsole.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":"2016-11-03T20:18:09.000Z","updated_at":"2024-06-19T17:09:43.000Z","dependencies_parsed_at":"2024-06-20T04:58:02.400Z","dependency_job_id":"94541d82-564e-444d-81a2-9bccd8b964d3","html_url":"https://github.com/nielsole/kudos","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/nielsole/kudos","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nielsole%2Fkudos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nielsole%2Fkudos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nielsole%2Fkudos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nielsole%2Fkudos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nielsole","download_url":"https://codeload.github.com/nielsole/kudos/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nielsole%2Fkudos/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30380092,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-11T06:09:32.197Z","status":"ssl_error","status_checked_at":"2026-03-11T06:09:17.086Z","response_time":84,"last_error":"SSL_read: 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":["blogging","like-button"],"created_at":"2026-03-11T11:39:23.661Z","updated_at":"2026-03-11T11:39:24.385Z","avatar_url":"https://github.com/nielsole.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kudos - A simple like button that can be self-hosted\n\n![A circle with a number below it](./static/kudos.png)\n\nKudos is similar to a like. By simply hovering over the button for a couple of seconds, a counter is inreased.\n[Example](https://www.niels-ole.com/kudos/blog/2016/11/04/now-with-kudos.html)\n\n## Quickstart\n\n1. Download `kudosplease.min.js` and `kudosplease.css` from the `frontend` folder\n2. Embed CSS and JS on your website\n   ```\n   \u003cscript src=\"kudosplease-min.js\"\u003e\u003c/script\u003e\n   \u003clink rel=\"stylesheet\" href=\"kudosplease-min.css\"\u003e\n   ```\n3. Create the widget: `\u003cdiv class=\"kudos\" data-amount=\"0\" data-url=\"example.com/my-awesome-article\"\u003e\u003c/div\u003e`\n4. Create the JS object:\n   ```\n   new KudosPlease({\n    el : '.kudos',\n    duration : 1500,\n    persistent : true,\n    status : {\n      alpha: 'fontelico-emo-shoot',\n      beta: 'fontelico-emo-shoot',\n      gamma: 'fontelico-emo-beer'\n    }\n   });\n   ```\n\n\n## Self-Hosting\n\nYou need to change the API endpoint stored int the JavaScript. Simply search kudosplease.min.js for `kudos.niels-ole.com` and replace it with your API endpoint.\n\nKudos requires a redis database that stores the state.\n\nBuilding the binary is easy: `go build -o kudos .`\n\n```\nUsage of ./kudos:\n  -admin-port string\n        Admin listen port; Provides metrics and debugging (default \":8081\")\n  -port string\n        Listening port (default \":8080\")\n  -redis-address string\n        redis host and port (default \"localhost:6379\")\n  -redis-db int\n        redis db to use\n  -redis-password string\n        redis password\n```\n\n### Docker\n\n```\nregistry.gitlab.com/nielsole/kudos/kudos\n```\n\n### From source\n\n```\ngo build main.go\n```\n\n## Contributors / History\n\nI really liked  http://kudosplease.com/ but their backend was really slow making it unusable, so I wrote my own.\n\nThanks to [Tim Pietrusky](https://github.com/TimPietrusky/) for creating kudos and publishing it under OSS.\n\n## Roadmap / Ideas\n\n* Ensure compatibility with different frontends for example [Get Claps](https://getclaps.app/) whose frontend is even closer to a like button.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnielsole%2Fkudos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnielsole%2Fkudos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnielsole%2Fkudos/lists"}