简单易扩展的 IRC 机器人
项目描述
简介
Sopel 是一个简单、轻量级、开源、易于使用的 IRC 工具机器人,用 Python 编写。它设计得易于使用、运行和扩展。
安装
最新稳定版本
在大多数可以运行Python的系统上,安装Sopel的最佳方式是安装pip,然后执行pip install sopel。
Arch用户可以从[社区]仓库安装sopel包,不过新版本可能需要稍长时间才能可用。
如果以上两种方法都不可行,您可以从GitHub获取最新的tarball,然后按照以下从最新源代码安装的步骤进行操作。
最新源代码
首先,使用git clone https://github.com/sopel-irc/sopel.git克隆仓库或从GitHub下载一个源代码压缩包。
注意:Sopel需要Python 3.8+才能运行。
在源代码目录(无论克隆还是从tarball)中运行pip install -e .。然后您可以运行sopel来配置和启动机器人。
数据库支持
Sopel利用SQLAlchemy支持以下数据库类型:SQLite、MySQL、PostgreSQL、MSSQL、Oracle、Firebird和Sybase。默认情况下,Sopel将使用当前配置目录中的SQLite数据库,但可以通过以下配置选项配置其他数据库:db_type、db_filename(仅SQLite)、db_driver、db_user、db_pass、db_host、db_port和db_name。您需要手动安装(系统或pip)以使所选数据库工作的任何所需的包。
注意:自Sopel 7.0发布以来未更新的插件可能存在与SQLite以外的数据库类型问题(但许多将正常运行)。
添加插件
将新插件放置在~/.sopel/plugins中是最容易的。一些较新的插件可以作为包安装;在PyPI上搜索这些。更多由其他用户编写的插件可以通过您喜欢的搜索引擎找到。
一些较老且未维护的插件可在sopel-extras仓库中找到,但当然您也可以自己编写。有关创建新插件的教程可在Sopel网站上找到。API文档可在网上找到,网址为https://sopel.chat/docs/,或者您可以通过运行make docs创建本地版本。
更多文档
有问题吗?
加入我们Libera Chat上的#sopel。
捐赠
我们很高兴您想支持这个项目!
您可以在GitHub上赞助Sopel,或者通过Open Collective进行捐赠。
收到的任何捐赠都将用于支付基础设施费用,如我们的域名和托管服务。我们的主要项目网站由Netlify轻松托管,但我们正在考虑构建一些需要更多静态托管的新功能。所有项目相关费用都记录在我们的Open Collective个人资料中,以提高透明度。