{"id":20800674,"url":"https://github.com/neelkamath/hack.chat-bot","last_synced_at":"2026-05-22T00:39:09.074Z","repository":{"id":103986882,"uuid":"181270011","full_name":"neelkamath/hack.chat-bot","owner":"neelkamath","description":"🤖 (DEPRECATED) A general use bot for hack.chat","archived":false,"fork":false,"pushed_at":"2019-04-18T08:47:35.000Z","size":65,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-18T12:29:24.456Z","etag":null,"topics":["bot","hack-chat","python"],"latest_commit_sha":null,"homepage":"","language":"Python","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/neelkamath.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-04-14T06:39:58.000Z","updated_at":"2021-02-01T04:40:26.000Z","dependencies_parsed_at":null,"dependency_job_id":"def3deee-d814-4a4e-a14f-e25c64ca07e0","html_url":"https://github.com/neelkamath/hack.chat-bot","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/neelkamath%2Fhack.chat-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/neelkamath%2Fhack.chat-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/neelkamath%2Fhack.chat-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/neelkamath%2Fhack.chat-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/neelkamath","download_url":"https://codeload.github.com/neelkamath/hack.chat-bot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243147271,"owners_count":20243745,"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":["bot","hack-chat","python"],"created_at":"2024-11-17T18:14:51.510Z","updated_at":"2025-12-26T01:27:00.452Z","avatar_url":"https://github.com/neelkamath.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# hack.chat bot\n\n**NOTE: This project has been deprecated because hack.chat is no longer actively maintained and hardly anyone uses the site (including me).**\n\nThis is a bot for [hack.chat](https://github.com/hack-chat/main) instances.\n\nhack.chat is a messaging site where you have the ability to run bots. You can enter a chat by following the URL with `?\u003cNAME\u003e`, where `\u003cNAME\u003e` is the name of the chat (e.g., https://hack.chat/?math). Anyone can enter this channel if they go to that URL.\n\nThis bot was made because the existing bots on hack.chat either lacked useful features or poorly implemented them. \n\n\u003cimg src=\"images/ddg.png\" alt=\"DuckDuckGo Logo\" height=\"50\" width=\"50\"\u003e The search feature of this bot uses [DuckDuckGo's API](https://duckduckgo.com/).\n\nThis application was written using Python and MongoDB.\n\n![Commands](images/screenshot.png)\n\n# Installation\n\n1. A [Heroku account](https://signup.heroku.com/?c=70130000001x9jFAAQ)\n1. Install the [Heroku CLI](https://devcenter.heroku.com/articles/heroku-cli#download-and-install)\n1. Log in: `heroku login`\n1. Clone the repository:\n    - HTTPS: `git clone https://github.com/neelkamath/hack.chat-bot.git`\n    - SSH: `git clone git@github.com:neelkamath/hack.chat-bot.git`\n1. Change the directory: `cd hack.chat-bot`\n1. Create a Heroku app: `heroku create \u003cNAME\u003e`, where `\u003cNAME\u003e` is an optional parameter to specify your app's name (a random name will be generated if you don't specify one)\n1. Push the code: `git push heroku master`\n1. Install dependencies:\n    - Librato: `heroku addons:create librato:development`\n    - mLab: `heroku addons:create mongolab:sandbox`\n    - Papertrail: `herou addons:create papertrail:choklad`\n1. Configure the app using the table below. The command to add a configuration variable is `heroku config:set \u003cKEY\u003e=\"\u003cVALUE\u003e\"` (e.g., `heroku config:set CHANNELS=\"bottest, gaming, pokemon\"`). Also create a file named `.env` in the `hack.chat-bot` directory with these key-value pairs (each pair on its own line) with the syntax `\u003cKEY\u003e=\"\u003cVALUE\u003e\"`. `\u003cKEY\u003e` is the variable's name, and `\u003cVALUE\u003e` is its value.\n\n|Variable|Explanation|Required|Example|\n|--------|-----------|--------|-------|\n|`CHANNELS`|A list of channels to connect to. The bot won't be allowed to leave these channels. Each channel should be separated with a comma followed by a space.|Yes|`botDev, math, pokemon`|\n|`TRIGGER`|The trigger for the bot (e.g., setting the trigger to ! would make the bot respond to !joke).|Yes|.|\n|`MONGODB_URI`|The URI of the mLab database. Get its value with `heroku config:get MONGODB_URI`||\n|`URL`|The hack.chat instance to connect to. Use wss://hack.chat/chat-ws for the original hack.chat.|Yes|wss://hack.chat/chat-ws|\n|`NICK`|The bot's nickname. Nickname must consist of up to 24 letters, numbers, and underscores. If the nickname has already been taken on a channel, the bot will be unable to connect to that channel.|Yes|john_doe|\n|`CODE_URL`|The link to the project's source code.|No|`https://gitlab.com/neelkamath/hack.chat-bot`|\n|`EXCHANGE_RATE_API_KEY`|Your [ExchangeRate-API](https://www.exchangerate-api.com/) API key.|No||\n|`OXFORD_APP_ID`|Your [Oxford Dictionaries](https://developer.oxforddictionaries.com/) App ID.|No||\n|`OXFORD_APP_KEY`|Your [Oxford Dictionaries](https://developer.oxforddictionaries.com/) App Key.|No||\n|`PASSWORD`|A trip code is a randomly generated code based on a password. Entering the same password gives the same trip code each time. This allows people in anonymous chatting sites to verify if a user is who they claim to be regardless of their nickname.|No|hot$auce|\n\n# Usage\n\n1. Change the directory: `cd hack.chat-bot`\n1. Run:\n    - On the server:\n        - Start: `heroku ps:scale bot=1`\n        - View logs: `heroku logs --tail`\n    - Locally:\n        - Install `virtualenv`:\n            - Windows: `pip install virtualenv`\n            - Other: `sudo pip3 install virtualenv`\n        - Create a virtual environment: `virtualenv venv`\n        - Activate the virtual environment:\n            - Windows: `venv\\Scripts\\activate.bat`\n            - Other: `source venv/bin/activate`\n        - Install the dependencies:\n            - Windows: `pip install -r requirements.txt`\n            - Other: `pip3 install -r requirements.txt`\n        - Start: `heroku local`\n\n# [Documentation](DOCUMENTATION.md)\n\n# License\n\nThis project is under the [MIT License](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fneelkamath%2Fhack.chat-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fneelkamath%2Fhack.chat-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fneelkamath%2Fhack.chat-bot/lists"}