{"id":13715624,"url":"https://github.com/CloudBotIRC/CloudBot","last_synced_at":"2025-05-07T04:30:57.863Z","repository":{"id":16508234,"uuid":"19261202","full_name":"CloudBotIRC/CloudBot","owner":"CloudBotIRC","description":"CloudBot - The simple, fast, expandable, open-source Python IRC Bot!","archived":false,"fork":false,"pushed_at":"2023-12-24T07:05:06.000Z","size":45471,"stargazers_count":274,"open_issues_count":64,"forks_count":249,"subscribers_count":28,"default_branch":"master","last_synced_at":"2024-11-14T03:34:33.569Z","etag":null,"topics":["cloudbot","irc","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CloudBotIRC.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","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}},"created_at":"2014-04-29T02:33:16.000Z","updated_at":"2024-11-13T08:38:51.000Z","dependencies_parsed_at":"2024-01-07T00:09:01.866Z","dependency_job_id":null,"html_url":"https://github.com/CloudBotIRC/CloudBot","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CloudBotIRC%2FCloudBot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CloudBotIRC%2FCloudBot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CloudBotIRC%2FCloudBot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CloudBotIRC%2FCloudBot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CloudBotIRC","download_url":"https://codeload.github.com/CloudBotIRC/CloudBot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252813716,"owners_count":21808374,"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":["cloudbot","irc","python"],"created_at":"2024-08-03T00:01:01.260Z","updated_at":"2025-05-07T04:30:56.045Z","avatar_url":"https://github.com/CloudBotIRC.png","language":"Python","readme":"# CloudBot\n\nCloudBot is a simple, fast, expandable open-source Python IRC Bot!\n\n## Project Status \u0026 A more updated CloudBot\n\nCloudBot is currently unmaintained. The project possibly usable, but there are currently no developers building new features or fixing bugs.\n\nThere are several forks of CloudBot which you may want to use instead. These projects have much more work done on them, and are thus incompatible. If you already have a running CloudBot instance you will probably need to start over from\nscratch.\n\n- TotallyNotRobots/CloudBot : [https://github.com/snoonetIRC/CloudBot](https://github.com/TotallyNotRobots/CloudBot)\n\n  This is a more active fork being created by members of Snoonet that might be a better option for your needs. Keep in mind that, as a project more than a thousand commits ahead of this one, if you already have a running CloudBot instance you will probably need to start over from scratch.\n\n- gonzobot : https://github.com/edwardslabs/CloudBot\n\nIf there are any other maintained forks of CloudBot, pull requests to add them to the README are welcome.\n\n## Getting CloudBot\n\nThere are currently two different branches of this repository, each with a different level of stability:\n - **master** *(stable)*: This branch contains stable, tested code. This is the branch you should be using if you just want to run your own CloudBot! [![Build Status](https://travis-ci.org/CloudBotIRC/CloudBot.svg?branch=master)](https://travis-ci.org/CloudBotIRC/CloudBot)\n - **python3.4** *(unstable)*: This branch is where we test and develop new features. If you would like to help develop CloudBot, you can use this branch. [![Build Status](https://travis-ci.org/CloudBotIRC/CloudBot.svg?branch=python3.4)](https://travis-ci.org/CloudBotIRC/CloudBot)\n \nNew releases will be pushed from **python3.4** to **master** whenever we have a stable version to release. This should happen on a fairly regular basis, so you'll never be too far behind the latest improvements.\n\n## Installing CloudBot\n\nFirstly, CloudBot will only run on **Python 3.4 or higher**. Because we use the asyncio module, you will not be able to use any other versions of Python.\n\nTo install CloudBot on *nix (linux, etc), see [here](https://github.com/CloudBotIRC/CloudBot/wiki/Installing-on-*nix)\n\nTo install CloudBot on Windows, see [here](https://github.com/CloudBotIRC/CloudBot/wiki/Installing-on-Windows)\n\n\n### Running CloudBot\n\nBefore you run the bot, rename `config.default.json` to `config.json` and edit it with your preferred settings. You can check if your JSON is valid using [jsonlint.com](http://jsonlint.com/)!\n\nOnce you have installed the required dependencies and renamed the config file, you can run the bot! Make sure you are in the correct folder and run the following command:\n\n```\npython3.4 -m cloudbot\n```\n\nNote that you can also run the `cloudbot/__main__.py` file directly, which will work from any directory.\n```\npython3.4 CloudBot/cloudbot/__main__.py\n```\nSpecify the path as /path/to/repository/cloudbot/__main__.py, where `cloudbot` is inside the repository directory.\n\n## Getting help with CloudBot\n\n### Documentation\n\nThe CloudBot documentation is currently somewhat outdated and may not be correct. If you need any help, please visit our [IRC channel](irc://irc.esper.net/cloudbot) and we will be happy to assist you.\n\nTo write your own plugins, visit the [Plugins Wiki Page](https://github.com/CloudBotIRC/CloudBot/wiki/Writing-your-first-command-plugin).\n\nMore at the [Wiki Main Page](https://github.com/CloudBotIRC/CloudBot/wiki).\n\n### Support\n\nThe developers reside in [#CloudBot](irc://irc.esper.net/cloudbot) on [EsperNet](http://esper.net) and would be glad to help you.\n\nIf you think you have found a bug/have an idea/suggestion, please **open an issue** here on Github and contact us on IRC!\n\n## Example CloudBots\n\nYou can find a number of example bots in [#CloudBot](irc://irc.esper.net/cloudbot \"Connect via IRC to #CloudBot on irc.esper.net\").\n\n## Changelog\n\nSee [CHANGELOG.md](https://github.com/CloudBotIRC/CloudBot/blob/master/CHANGELOG.md)\n\n## License\n\nCloudBot is **licensed** under the **GPL v3** license. The terms are as follows.\n\n![GPL V3](https://www.gnu.org/graphics/gplv3-127x51.png)\n    \n    CloudBot\n\n    Copyright © 2011-2015 Luke Rogers / CloudBot Project\n\n    CloudBot is free software: you can redistribute it and/or modify\n    it under the terms of the GNU General Public License as published by\n    the Free Software Foundation, either version 3 of the License, or\n    (at your option) any later version.\n\n    CloudBot is distributed in the hope that it will be useful,\n    but WITHOUT ANY WARRANTY; without even the implied warranty of\n    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n    GNU General Public License for more details.\n\n    You should have received a copy of the GNU General Public License\n    along with CloudBot.  If not, see \u003chttp://www.gnu.org/licenses/\u003e.\n    \nThis product includes GeoLite2 data created by MaxMind, available from\n\u003ca href=\"http://www.maxmind.com\"\u003ehttp://www.maxmind.com\u003c/a\u003e. GeoLite2 databases are distributed under the [Creative Commons Attribution-ShareAlike 3.0 Unported License](https://creativecommons.org/licenses/by-sa/3.0/)\n\n![Powered by wordnik](https://www.wordnik.com/img/wordnik_badge_a1.png)\n\nThis product uses data from \u003ca href=\"http://wordnik.com\"\u003ehttp://wordnik.com\u003c/a\u003e in accordance with the wordnik.com API \u003ca href=\"http://developer.wordnik.com/#!/terms\"\u003eterms of service\u003c/a\u003e.\n","funding_links":[],"categories":["Chat and ChatOps","ChatOps","Python","Uncategorized"],"sub_categories":["Threat modelling","Uncategorized"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCloudBotIRC%2FCloudBot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FCloudBotIRC%2FCloudBot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCloudBotIRC%2FCloudBot/lists"}