Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hlmtre/pybot
An extensible, modular, configurable, and multi-threaded python irc bot.
https://github.com/hlmtre/pybot
pybot python-irc-bot
Last synced: 2 months ago
JSON representation
An extensible, modular, configurable, and multi-threaded python irc bot.
- Host: GitHub
- URL: https://github.com/hlmtre/pybot
- Owner: hlmtre
- License: gpl-3.0
- Created: 2012-03-31T03:52:14.000Z (almost 13 years ago)
- Default Branch: master
- Last Pushed: 2024-07-29T18:15:27.000Z (5 months ago)
- Last Synced: 2024-10-25T00:46:32.817Z (3 months ago)
- Topics: pybot, python-irc-bot
- Language: Python
- Homepage:
- Size: 1.96 MB
- Stars: 10
- Watchers: 3
- Forks: 4
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES
- License: LICENSE
Awesome Lists containing this project
README
[](https://travis-ci.org/hlmtre/pybot)
[](https://pybot.readthedocs.io/en/master/?badge=master)
[](https://scrutinizer-ci.com/g/hlmtre/pybot/?branch=master)
[ReadTheDocs documentation](http://pybot.readthedocs.org/en/master/ "ReadTheDocs pybot documentation")
pybot is a python irc bot. he is a project.
-------------------------------------------
he is modular, extensible, multi-threaded (for network independence!), and configurable.
pybot runs on python 2.7 and >3.5, on both windows and linux, though current development is all geared towards >3.5.
**master branch should be stable. feature branches can be broken at any time.**
If You've Got Docker
====================
This is mucho easier-o. Just
----------------------------
docker build . -t pybox
docker run -it pybox --nick --server --port 6667 --channels "#c1, #c2" --owner
(Now probably more than) 10-second TL;DR:
=========================================
Take care of dependencies. If you don't use MySQL and don't care about certain modules breaking, you don't need anything but python 2.7/3.5 and standard libs.
-----------------------------------------------------------------------------------------------------------------------------------------------------
python -m venv pybot-venv
source pybot-venv/bin/activate
# so as to not stuff pips everywhere
pip install -r requirements.txt
* python-dev
* libmysqlclient-dev (aka mysql-python in pip)
* requests (used in a variety of modules)
* praw (for reddit info module)
* mysql-python (if you do use mysql)
* sphinx (for docs)
* python-twitter (twitterposter)
* pytz (tzone)
Local Development (with sqlite3)
--------------------------------
1. Copy pybotrc to the user who will run the bot *(you can probably do `cp pybotrc ~/.pybotrc`)*
2. Modify ~/.pybotrc with your network, owner, and nickname.
3. `./pybot.py`
4. laugh at mysql guys.
5. continue laughing.
6. for debugging purposes, `./pybot.py -d.`
Local Development (with MySQL)
------------------------------
1. modify pybotrc with your channels and passwords.
2. run `sudo ./bootstrap.sh` to install pybot dependencies such as mysql.
3. run `./setup.sh`. It will check for module dependencies and create a mysql\_init file. `mysql -p < mysql\_init`
4. `./pybot.py pybotrc`
5. rejoice.
6. for debugging purposes, `./pybot.py -d.`
Manual
------
Add a mysql user for pybot with permissions to update, insert, and delete from the created tables.
Logged into mysql: `grant all on .* to '' identified by '';`
Run the included mysql\_dump file (as root, `mysql -p < mysql\_dump`).
Set his dbpass in the config file (pybotrc) to the password you've given him.
Copy that config file to the home folder of whatever user will be running the bot. (~user/.pybotrc)
As that user, `./pybot.py.`
Vagrant Development
-------------------
If you have Vagrant locally installed and configured, you can set up pybot by invoking
`vagrant up`. Your development environment will be configured, and you can skip step 1 and
2 above. After that, SSH into your VM and do steps 3 through 5 to finish things off.
Images & Explanation
====================
Here pybot is connected to two networks at once. They are held entirely separately. Modules loaded on one are independent of modules loaded on another.
If one server goes down, the other connections to other networks are unaffected.
TODO
----
* add birthday module (save birthdays for your channel regulars!)
* update scheduler to accept *at* commands - .schedule at 5pm say #development pick your child from daycare