PepperBot

PepperBot

Born cross-platform

• QQ is based on Onebot , Mirai (to be implemented), OPQ (to be implemented)
• WeChat is based on可爱猫
• Telegram is based on Pyrogram
• Provides cross-platform, easy-to-use message types (fragments)
• Universal events, such as group messages, private messages, etc., provide a unified interface. You only need to write code once and it can be seamlessly applied to various platforms. Cross-platform messaging has never been so easy and casual.
• You can share instructions (status) across groups and platforms, or lock users globally (regardless of whether the user is in a group chat or a private chat)

Performance is enough

• The bottom layer is based on the asynchronous Sanic framework. Among the python web frameworks with a certain ecology, it has the best performance.
• It is lightweight and mainly processes messages. For other functions, it exposes the underlying interface to facilitate in-depth customization.
• A few lines of code can achieve multi-process load balancing

Bring your own bucket for the whole family

• Supports Django or starlette style centralized routing, or flask or fastAPI style decorator routing
• A very flexible permission system that supports routing, class, and method level permission control.
• Django class view style or Vue life cycle style command system
• scheduled tasks
• Logging support
• Asynchronous database support based on ormar (ormar is based on sqlalchemy + pydantic )
• Comes with a plug-in market that can install community instructions
• Provide cli tools to quickly create projects
• Selenium -like event waiting
• fastAPI style dependency injection

interface and semantics

• The API is intuitive, intuitive, and fluently maps ideas to code.
• Based on type annotations after python3.6, complete type hints are provided
• Most of the parameters that can be obtained automatically will be obtained automatically, and there is no need to provide them manually every time.
• Only the parameters used will be dynamically injected, so there is no need to write a long list of unused parameters every time!
• In the documents, there are code snippets that can be directly copied and used for rapid development.

Full test documentation

• Comes with linter
  • Through meta-programming (AST and the like), the rules are checked on various codes written and easy-to-understand error messages are output to eliminate problems before the framework is started.
• The documentation is relatively complete
• Test coverage is relatively comprehensive
• Lots of official examples/instructions
• QA from the author (join the group to get it)

Install

pip install pepperbot

use

See the documentation for specific usage

Example

Six lines of code to implement message exchange

 class WhateverNameYouWant :
    async def group_message ( self , bot : UniversalGroupBot , chain : MessageChain ):
        if bot . onebot : # 转发qq消息至微信、TG
            await bot . arbitrary . keaimao . group_message ( "19521241254@chatroom" , * chain . segments )
            await bot . arbitrary . telegram . group_message ( "bot_father" , * chain . segments )

        if bot . keaimao : # 转发微信消息至qq、TG
            await bot . arbitrary . onebot . group_message ( "1041902989" , * chain . segments )
            await bot . arbitrary . telegram . group_message ( "bot_father" , * chain . segments )

Only a very small amount of code is required to implement cross-platform group message response.

 @ register ()
class WhateverNameYouWant :

    # 注册跨平台群事件
    async def group_message ( self , bot : GroupBot , chain : MessageChain , sender : Sender ):
        # chain即为消息链，pure_text是消息中的纯文本，不包含表情、图片等
        if "撤回我" == chain . pure_text :
            await chain . withdraw () # 可以直接“撤回消息”，符合直觉

        if "踢出我" == chain . pure_text :
            await sender . kickout () # 可以直接踢出发言群员

        # 也可以对消息链进行in操作，相当于in chain.pure_text
        if "禁言我" in chain :
            await sender . ban ( 10 ) # 可以直接禁言发言群员

        if chain . regex ( "有人(在|吗|嘛|在吗).?" ):
            # 发送一条群消息
            # 接受任意个参数，必须是合法的消息片段，比如Text，Face，Image
            await bot . group_message (
                Text ( "没人" ),
                Image ( "http://123.jpg" ),
            )

ecology

plug-in market

GPT group chat bot that can remember context

pepperbot-ai-query

Automatically detect advertising information in group chats through GPT