Limnoria/README.md

59 lines
2.2 KiB
Markdown
Raw Normal View History

Supybot is a robust (it doesn't crash), user friendly (it's easy to
configure) and programmer friendly (plugins are *extremely* easy to
write) Python IRC bot. It aims to be an adequate replacement for most
existing IRC bots. It includes a very flexible and powerful ACL system
for controlling access to commands, as well as more than 50 builtin plugins
providing around 400 actual commands.
2018-07-09 12:01:27 +02:00
Limnoria is the project which continues development of Supybot since 2010.
# Build status
2013-01-23 17:11:52 +01:00
Master branch: [![Build Status (master branch)](https://travis-ci.org/ProgVal/Limnoria.png?branch=master)](https://travis-ci.org/ProgVal/Limnoria)
2013-01-23 17:11:52 +01:00
Testing branch: [![Build Status (testing branch)](https://travis-ci.org/ProgVal/Limnoria.png?branch=testing)](https://travis-ci.org/ProgVal/Limnoria)
2013-01-18 18:38:10 +01:00
Limnoria supports CPython 3.4, 3.5, 3.6, 3.7, nightly;
and Pypy 3.
2013-04-27 19:08:20 +02:00
# Support
## Documentation
2005-01-19 14:14:38 +01:00
2020-03-17 19:19:00 +01:00
If this is your first install, there is an [install guide](https://docs.limnoria.net/en/latest/use/install.html).
You will probably be pointed to it if you ask on IRC how to install
Limnoria.
TL;DR version:
```
sudo apt-get install python3 python3-pip python3-wheel
pip3 install --user limnoria
# You might need to add $HOME/.local/bin to your PATH
supybot-wizard
```
2020-03-17 19:19:00 +01:00
There is extensive documentation at [docs.limnoria.net] and at
[Gribble wiki]. We took the time to write it; you should take the time to
read it.
2005-01-19 14:14:38 +01:00
2020-03-17 19:19:00 +01:00
[docs.limnoria.net]:https://docs.limnoria.net/
2016-01-05 17:51:18 +01:00
[Gribble wiki]:https://sourceforge.net/p/gribble/wiki/Main_Page/
## IRC channels
### In English
If you have any trouble, feel free to swing by [#supybot and #limnoria](ircs://chat.freenode.net:6697/#supybot,#limnoria) on
[freenode](https://freenode.net/) or [#supybot](ircs://irc.oftc.net:6697/#supybot) at [OFTC](http://oftc.net/) (we have a Limnoria there relaying,
2005-01-19 14:14:38 +01:00
so either network works) and ask questions. We'll be happy to help
wherever we can. And by all means, if you find anything hard to
understand or think you know of a better way to do something,
2014-03-01 08:43:17 +01:00
*please* post it on the [issue tracker] so we can improve the bot!
2005-01-19 14:14:38 +01:00
[issue tracker]:https://github.com/ProgVal/Limnoria/issues
### In Other languages
2015-02-04 13:48:31 +01:00
Only in French at the moment, located at [#supybot-fr on freenode](ircs://chat.freenode.net:6697/#supybot-fr).