pinhook/README.md

25 lines
643 B
Markdown
Raw Normal View History

2017-09-27 19:03:20 +00:00
# pinhook
a pluggable irc bot framework in python
2017-09-28 13:34:07 +00:00
2017-10-02 17:28:39 +00:00
# Currently in very early stages and may change wildly until final release
2017-09-28 13:34:07 +00:00
2017-10-02 17:28:39 +00:00
## Tutorial
### Installation
```
$ pip install git+git://github.com/archangelic/pinhook.git
```
### Creating the Bot
To create the bot, just create a python file with the following:
```python
import pinhook.bot
bot = pinhook.bot.Bot(channels=['#foo', '#bar'], nickname='ph-bot', server='irc.freenode.net')
bot.start()
```
This will start a basic bot and look for plugins in the 'plugins' directory to add functionality.
Optionally, you can change the `port` and add a list of operators with the `ops` argument.