https://github.com/erispulse/erispulse
ErisPulse - 一个 Python 异步优先 的机器人框架，支持插件化扩展、多协议适配
https://github.com/erispulse/erispulse
async asyncio automation await bot eris erispulse framework module multiprotocol plugin python sdk
Last synced: 23 days ago
JSON representation
ErisPulse - 一个 Python 异步优先 的机器人框架，支持插件化扩展、多协议适配
- Host: GitHub
- URL: https://github.com/erispulse/erispulse
- Owner: ErisPulse
- License: other
- Created: 2025-03-30T06:00:03.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2026-01-18T17:34:50.000Z (2 months ago)
- Last Synced: 2026-01-19T00:46:46.757Z (2 months ago)
- Topics: async, asyncio, automation, await, bot, eris, erispulse, framework, module, multiprotocol, plugin, python, sdk
- Language: Python
- Homepage: https://www.erisdev.com
- Size: 18.3 MB
- Stars: 15
- Watchers: 1
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# ErisPulse - 异步机器人开发框架
[](https://pypi.org/project/ErisPulse/)
[](https://pypi.org/project/ErisPulse/)
[](https://github.com/astral-sh/ruff)
[](https://socket.dev/pypi/package/ErisPulse)
## 文档资源
| 平台 | 主站点 | 备用站点 |
|------|--------|---------|
| 文档 | [erisdev.com](https://www.erisdev.com/#docs) | [Cloudflare](https://erispulse.pages.dev/#docs) • [GitHub](https://erispulse.github.io/#docs) • [Netlify](https://erispulse.netlify.app/#docs) |
| 模块市场 | [erisdev.com](https://www.erisdev.com/#market) | [Cloudflare](https://erispulse.pages.dev/#market) • [GitHub](https://erispulse.github.io/#market) • [Netlify](https://erispulse.netlify.app/#market) |
## 核心特性
| 特性 | 描述 |
|:-----|:-----|
| 异步架构 | 完全基于 async/await 的异步设计 |
| 模块化系统 | 灵活的插件和模块管理 |
| 热重载 | 开发时自动重载，无需重启 |
| 错误管理 | 统一的错误处理和报告系统 |
| 配置管理 | 灵活的配置存储和访问 |
## 快速开始
### 一键安装脚本
#### Windows (PowerShell):
```powershell
irm https://get.erisdev.com/install.ps1 -OutFile install.ps1; powershell -ExecutionPolicy Bypass -File install.ps1
```
#### macOS/Linux:
```bash
curl -sSL https://get.erisdev.com/install.sh | tee install.sh >/dev/null && chmod +x install.sh && ./install.sh
```
## 开发与测试
### 1. 克隆项目
```bash
git clone -b Develop/v2 https://github.com/ErisPulse/ErisPulse.git
cd ErisPulse
```
### 2. 环境搭建
使用 uv 同步项目环境:
```bash
uv sync
# 激活虚拟环境
source .venv/bin/activate # macOS/Linux
# Windows: .venv\Scripts\activate
```
说明: ErisPulse 使用 Python 3.13 开发，但兼容 Python 3.10+
### 3. 安装依赖
```bash
uv pip install -e .
```
这将以"开发模式"安装 SDK，所有本地修改都会立即生效。
### 4. 验证安装
运行以下命令确认 SDK 正常加载：
```bash
python -c "from ErisPulse import sdk; sdk.init()"
```
### 5. 运行测试
我们提供了一个交互式测试脚本，可以帮助您快速验证SDK功能：
```bash
uv run devs/test.py
```
测试功能包括:
- 日志系统测试
- 环境配置测试
- 错误管理测试
- 工具函数测试
- 适配器功能测试
## 项目结构
```
ErisPulse/
├── src/
│ └── ErisPulse/ # 核心源代码
│ ├── Core/ # 核心模块
│ │ ├── Bases/ # 基础类定义
│ │ ├── Event/ # 事件系统
│ │ └── ... # 其他核心组件
│ └── __init__.py # SDK入口点
├── examples/ # 示例代码
├── devs/ # 开发工具
├── docs/ # 文档
├── tests/ # 测试代码
├── scripts/ # 脚本文件
└── config.toml # 默认配置文件
```
## 贡献指南
我们欢迎各种形式的贡献，包括但不限于:
1. 报告问题
在 [GitHub Issues](https://github.com/ErisPulse/ErisPulse/issues) 提交bug报告
2. 功能请求
通过 [社区讨论](https://github.com/ErisPulse/ErisPulse/discussions) 提出新想法
3. 代码贡献
提交 Pull Request 前请阅读我们的 [代码风格](docs/StyleGuide/DocstringSpec.md) 以及 [贡献指南](CONTRIBUTING.md)
4. 文档改进
帮助完善文档和示例代码
[加入社区讨论](https://github.com/ErisPulse/ErisPulse/discussions)
---
[](https://starchart.cc/ErisPulse/ErisPulse)