mirror of
https://github.com/PaiGramTeam/PaiGram.git
synced 2024-12-27 11:49:04 +00:00
138 lines
4.1 KiB
Markdown
138 lines
4.1 KiB
Markdown
<h1 align="center">PaiGram</h1>
|
|
|
|
<div align="center"><img src="https://img.shields.io/badge/python-3.11%2B-blue" alt="">
|
|
<img src="https://img.shields.io/badge/works%20on-my%20machine-brightgreen" alt="">
|
|
<img src="https://img.shields.io/badge/status-%E5%92%95%E5%92%95%E5%92%95-blue" alt="">
|
|
<a href="https://black.readthedocs.io/en/stable/index.html"><img src="https://img.shields.io/badge/code%20style-black-000000.svg" alt="code_style" /></a>
|
|
<a href="https://www.codacy.com/gh/PaiGramTeam/PaiGram/dashboard?utm_source=github.com&utm_medium=referral&utm_content=PaiGramTeam/PaiGram&utm_campaign=Badge_Grade"><img src="https://app.codacy.com/project/badge/Grade/ac5844e2b0d14a3e8aa16b9b1b099ce0" alt=""/></a>
|
|
</div>
|
|
|
|
<p>
|
|
<img src="https://user-images.githubusercontent.com/70872201/190447002-119a8819-b111-4a96-a0b3-701c5e256137.png" align="right" width="100px" alt="">
|
|
<h2 align="left">Introduction</h2>
|
|
|
|
PaiGram based on [python-telegram-bot](https://github.com/python-telegram-bot/python-telegram-bot)
|
|
|
|
|
|
|
|
[中文文档](/docs/README_ZH.md)
|
|
|
|
## System Dependencies
|
|
|
|
- Python 3.11+
|
|
- MySQL or SQLite
|
|
- Redis
|
|
|
|
## Usage
|
|
|
|
Depending on your preferred environment, follow one of the setups below:
|
|
|
|
### WSL2 Ubuntu 22.04 Setup
|
|
|
|
For contributors using WSL2 on Ubuntu 22.04, follow the [detailed guide here](/docs/wsl/EN.md).
|
|
|
|
### Standard Setup (All Environments)
|
|
|
|
#### 1. Clone PaiGram from Git
|
|
|
|
```bash
|
|
git clone git@github.com:PaiGramTeam/PaiGram.git
|
|
cd PaiGram/
|
|
git submodule update --init --recursive
|
|
```
|
|
|
|
#### 2. Project Setup
|
|
|
|
It's recommended to use a virtual environment. You can set it up via `venv` or `virtualenv`.
|
|
|
|
**Create Virtual environment:**
|
|
|
|
```bash
|
|
python3 -m venv venv
|
|
```
|
|
|
|
**Activate the virtual environment:**
|
|
|
|
*For Linux:*
|
|
|
|
```bash
|
|
source venv/bin/activate
|
|
```
|
|
|
|
*For Windows Command Prompt:*
|
|
|
|
```bash
|
|
venv\Scripts\activate.bat
|
|
```
|
|
|
|
*For Windows PowerShell:*
|
|
|
|
```bash
|
|
.\venv\Scripts\Activate.ps1
|
|
```
|
|
|
|
**Install Dependencies:**
|
|
|
|
```bash
|
|
pip install uv
|
|
uv sync
|
|
playwright install chromium
|
|
```
|
|
|
|
Optional Dependencies
|
|
|
|
```bash
|
|
uv sync --all-extras
|
|
```
|
|
|
|
**Edit Config:**
|
|
|
|
Create a dotenv config (`.env`) based on the given example. Ensure to provide the necessary database connection
|
|
details and bot token parameters.
|
|
|
|
```bash
|
|
cp .env.example .env
|
|
```
|
|
|
|
For detailed configurations, refer to the [Wiki/Env Settings](https://github.com/PaiGramTeam/PaiGram/wiki/Env-Settings).
|
|
|
|
#### 3. Database Setup with Alembic
|
|
|
|
```bash
|
|
alembic upgrade head
|
|
```
|
|
|
|
#### 4. Run PaiGram
|
|
|
|
Ensure the `venv` is still active:
|
|
|
|
```bash
|
|
python ./run.py
|
|
```
|
|
|
|
### Alternative Deployments
|
|
|
|
- **Docker:** For deployments using Docker, see
|
|
the [Wiki/Deploy with Docker](https://github.com/PaiGramTeam/PaiGram/wiki/Deploy-with-Docker).
|
|
|
|
- **Podman:** For deployments using Podman, see
|
|
the [Wiki/Deploy with Podman](https://github.com/PaiGramTeam/PaiGram/wiki/Deploy-with-Podman).
|
|
|
|
## Additional Information
|
|
|
|
This project is currently being expanded,
|
|
adding more entertainment and information query features related to Genshin Impact.
|
|
Stay tuned!
|
|
|
|
## Acknowledgments
|
|
|
|
| Nickname | Introduce |
|
|
|:-----------------------------------------------------------------------:|------------------|
|
|
| [原神抽卡全机制总结](https://www.bilibili.com/read/cv10468091) | 本项目抽卡模拟器使用的逻辑 |
|
|
| [西风驿站 猫冬](https://bbs.mihoyo.com/ys/accountCenter/postList?id=74019947) | 本项目攻略图图源 |
|
|
| [Yunzai-Bot](https://github.com/Le-niao/Yunzai-Bot) | 本项使用的抽卡图片和前端资源来源 |
|
|
| [Crawler-ghhw](https://github.com/DGP-Studio/Crawler-ghhw) | 本项目参考的爬虫代码 |
|
|
| [Enka.Network](https://enka.network) | 角色卡片的数据来源 |
|
|
| [miao-plugin](https://github.com/yoimiya-kokomi/miao-plugin) | 角色卡片的参考项目 |
|
|
| [DGP HuTao API](https://hut.ao/en/) | 深渊数据来源 |
|