{"id":45975086,"url":"https://github.com/flipdot/forumbot","last_synced_at":"2026-02-28T16:04:15.282Z","repository":{"id":37663426,"uuid":"200889703","full_name":"flipdot/forumbot","owner":"flipdot","description":null,"archived":false,"fork":false,"pushed_at":"2026-02-25T23:42:26.000Z","size":596,"stargazers_count":5,"open_issues_count":7,"forks_count":0,"subscribers_count":10,"default_branch":"master","last_synced_at":"2026-02-26T01:16:46.409Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/flipdot/forumbot","language":"Python","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/flipdot.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2019-08-06T16:43:53.000Z","updated_at":"2026-02-25T23:42:28.000Z","dependencies_parsed_at":"2023-01-30T03:35:13.415Z","dependency_job_id":"d342ca74-d4aa-4f81-9bd5-d526d3459049","html_url":"https://github.com/flipdot/forumbot","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/flipdot/forumbot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flipdot%2Fforumbot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flipdot%2Fforumbot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flipdot%2Fforumbot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flipdot%2Fforumbot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/flipdot","download_url":"https://codeload.github.com/flipdot/forumbot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flipdot%2Fforumbot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29941807,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-28T13:49:17.081Z","status":"ssl_error","status_checked_at":"2026-02-28T13:48:50.396Z","response_time":90,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5: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":[],"created_at":"2026-02-28T16:04:14.911Z","updated_at":"2026-02-28T16:04:15.274Z","avatar_url":"https://github.com/flipdot.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# flipdot Discourse bot\n\n## Usage\n\n    docker run -d -e DISCOURSE_API_KEY=fefe flipdot/forumbot\n    # if you want to run on another discourse instance:\n    docker run -d -e DISCOURSE_API_KEY=fefe -e DISCOURSE_USERNAME=hello -e DISCOURSE_HOST=https://forum.example.com flipdot/forumbot\n\n## Deployment\n\nChanges on the master branch are automatically build into a docker image and\npublished at [docker hub](https://hub.docker.com/r/flipdot/forumbot).\nAfter it is published, you need to adjust [this ansible playbook](https://code.flipdot.org/flipdot-infra/ansible/src/branch/main/host_vars/spouting-whale.yml)\n\nCheckout if a change to the ansible playbook is automatically deployed yet - at the time of writing this,\nyou need to run the playbook manually. See details over at the other repository.\n\n## Developing\n\n### Compose setup\n\nIf you are not able to get an API key for forum.flipdot.org, try the compose setup:\n\n```\ndocker compose up\n```\n\nGo to http://localhost:3000/ and login with user `user@example.com` and password `bitnami123`\n\n### Running\n\nClone this repo, make your changes, build a new container:\n\n    ./build_docker.sh\n    DISCOURSE_API_KEY=fefe ./run_docker.sh\n    # or with the test user\n    DISCOURSE_API_KEY=fefe DISCOURSE_USERNAME=flipbot_test ./run_docker.sh\n\nOr, if you want to develop without docker:\n\n    uv sync\n    DISCOURSE_API_KEY=fefe uv run python src/app.py\n    # or with the test user\n    DISCOURSE_API_KEY=fefe DISCOURSE_USERNAME=flipbot_test uv run python src/app.py\n\nYou can get the credentials of flipdot_test in our forum: https://forum.flipdot.org/t/api-key-fuer-flipbot-test/3755\n\nCopy .env.example to .env and set the API key there, so you don't have to set it every time.\n\n    cp .env.example .env\n\nExecute tests:\n\n    PYTHONPATH=src uv run pytest\n\n### How to add a job?\n\nStart by copying `src/tasks/hello_world.py`. You can run your new task directly:\n\n    uv run python src/app.py --dry --run_task hello_world\n\n...where \"hello_world\" is the name of the python file.\n\nModify the `main()` function:\n\n    def main(client: DiscourseClient) -\u003e None:\n        # Do your stuff here.\n        # You can use the client object to interact with discourse\n        pass\n\nNext, open `src/app.py`. Add an `import tasks.my_awesome_task` to the top of the file.\nSchedule your task inside the function `schedule_jobs`:\n\n    schedule.every().day.at('13:37').do(tasks.my_awesome_task.main, client)\n\nTake a look at [schedule](https://schedule.readthedocs.io/en/stable/) to see how to specify when to run your task.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflipdot%2Fforumbot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fflipdot%2Fforumbot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflipdot%2Fforumbot/lists"}