跳转到主要内容

简单易扩展的 IRC 机器人

项目描述

version build issues coverage-status license

简介

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_typedb_filename(仅SQLite)、db_driverdb_userdb_passdb_hostdb_portdb_name。您需要手动安装(系统或pip)以使所选数据库工作的任何所需的包。

注意:自Sopel 7.0发布以来未更新的插件可能存在与SQLite以外的数据库类型问题(但许多将正常运行)。

添加插件

将新插件放置在~/.sopel/plugins中是最容易的。一些较新的插件可以作为包安装;在PyPI上搜索这些。更多由其他用户编写的插件可以通过您喜欢的搜索引擎找到。

一些较老且未维护的插件可在sopel-extras仓库中找到,但当然您也可以自己编写。有关创建新插件的教程可在Sopel网站上找到。API文档可在网上找到,网址为https://sopel.chat/docs/,或者您可以通过运行make docs创建本地版本。

更多文档

官方网站包括以下有价值的信息:内置命令的完整列表、教程API文档和其他使用信息

有问题吗?

加入我们Libera Chat上的#sopel

捐赠

我们很高兴您想支持这个项目!

您可以在GitHub上赞助Sopel,或者通过Open Collective进行捐赠。

收到的任何捐赠都将用于支付基础设施费用,如我们的域名和托管服务。我们的主要项目网站由Netlify轻松托管,但我们正在考虑构建一些需要更多静态托管的新功能。所有项目相关费用都记录在我们的Open Collective个人资料中,以提高透明度。

支持者

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF 赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误记录 StatusPage StatusPage 状态页面