1
Fork 0
mirror of https://github.com/RYGhub/royalnet.git synced 2024-11-23 19:44:20 +00:00
royalnet/README.md

53 lines
1.5 KiB
Markdown

# `royalnet` [![PyPI](https://img.shields.io/pypi/v/royalnet.svg)](https://pypi.org/project/royalnet/)
A multipurpose bot framework and webserver
## About
`royalnet` is a Python framework that allows you to create interconnected modular chat bots accessible through multiple interfaces (such as Telegram or Discord), and also modular websites that can be connected with the bots.
### Supported bot platforms ("serfs")
- [Telegram](https://core.telegram.org/bots)
- [Discord](https://discordapp.com/developers/docs/)
- [Matrix]() (no E2E support yet)
## Installing
To install all `royalnet` modules, run:
```
royalnet[telegram,discord,alchemy_easy,bard,constellation,sentry,herald,coloredlogs]
```
> You will soon be able to install only the modules you need instead of the full package, but the feature isn't ready yet...
## Developing `royalnet`
To develop `royalnet`, you need to have [Poetry](https://poetry.eustace.io/) installed on your PC.
After you've installed Poetry, clone the git repo with the command:
```
git clone https://github.com/Steffo99/royalnet
```
Then enter the new directory:
```
cd royalnet
```
And finally install all dependencies and the package:
```
poetry install -E telegram -E discord -E alchemy_easy -E bard -E constellation -E sentry -E herald -E coloredlogs
```
## Developing `royalnet` packages
See the [royalnet-pack-template](https://github.com/Steffo99/royalnet-pack-template) project.
## Documentation
`royalnet`'s documentation is available [here](https://gh.steffo.eu/royalnet).