AstrBot 4.29.1__tar.gz → 4.29.3__tar.gz

astrbot-4.29.3/.github/workflows/codeql.yml

@@ -0,0 +1,93 @@
+# For most projects, this workflow file will not need changing; you simply need
+# to commit it to your repository.
+#
+# You may wish to alter this file to override the set of languages analyzed,
+# or to provide custom queries or build logic.
+#
+# ******** NOTE ********
+# We have attempted to detect the languages in your repository. Please check
+# the `language` matrix defined below to confirm you have the correct set of
+# supported CodeQL languages.
+#
+name: "CodeQL"
+
+on:
+  push:
+    branches: [ "master" ]
+  pull_request:
+    branches: [ "master" ]
+  schedule:
+    - cron: '21 15 * * 5'
+
+jobs:
+  analyze:
+    name: Analyze (${{ matrix.language }})
+    # Runner size impacts CodeQL analysis time. To learn more, please see:
+    #   - https://gh.io/recommended-hardware-resources-for-running-codeql
+    #   - https://gh.io/supported-runners-and-hardware-resources
+    #   - https://gh.io/using-larger-runners (GitHub.com only)
+    # Consider using larger runners or machines with greater resources for possible analysis time improvements.
+    runs-on: ${{ (matrix.language == 'swift' && 'macos-latest') || 'ubuntu-latest' }}
+    timeout-minutes: ${{ (matrix.language == 'swift' && 120) || 360 }}
+    permissions:
+      # required for all workflows
+      security-events: write
+
+      # required to fetch internal or private CodeQL packs
+      packages: read
+
+      # only required for workflows in private repositories
+      actions: read
+      contents: read
+
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+        - language: python
+          build-mode: none
+        # CodeQL supports the following values keywords for 'language': 'c-cpp', 'csharp', 'go', 'java-kotlin', 'javascript-typescript', 'python', 'ruby', 'swift'
+        # Use `c-cpp` to analyze code written in C, C++ or both
+        # Use 'java-kotlin' to analyze code written in Java, Kotlin or both
+        # Use 'javascript-typescript' to analyze code written in JavaScript, TypeScript or both
+        # To learn more about changing the languages that are analyzed or customizing the build mode for your analysis,
+        # see https://docs.github.com/en/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/customizing-your-advanced-setup-for-code-scanning.
+        # If you are analyzing a compiled language, you can modify the 'build-mode' for that language to customize how
+        # your codebase is analyzed, see https://docs.github.com/en/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/codeql-code-scanning-for-compiled-languages
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v7
+
+    # Initializes the CodeQL tools for scanning.
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v4.39.0
+      with:
+        languages: ${{ matrix.language }}
+        build-mode: ${{ matrix.build-mode }}
+        # If you wish to specify custom queries, you can do so here or in a config file.
+        # By default, queries listed here will override any specified in a config file.
+        # Prefix the list here with "+" to use these queries and those in the config file.
+
+        # For more details on CodeQL's query packs, refer to: https://docs.github.com/en/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning#using-queries-in-ql-packs
+        # queries: security-extended,security-and-quality
+
+    # If the analyze step fails for one of the languages you are analyzing with
+    # "We were unable to automatically build your code", modify the matrix above
+    # to set the build mode to "manual" for that language. Then modify this step
+    # to build your code.
+    # ℹ️ Command-line programs to run using the OS shell.
+    # 📚 See https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsrun
+    - if: matrix.build-mode == 'manual'
+      shell: bash
+      run: |
+        echo 'If you are using a "manual" build mode for one or more of the' \
+          'languages you are analyzing, replace this with the commands to build' \
+          'your code, for example:'
+        echo '  make bootstrap'
+        echo '  make release'
+        exit 1
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v4.39.0
+      with:
+        category: "/language:${{matrix.language}}"

astrbot-4.29.3/.github/workflows/install_script_test.yml

@@ -0,0 +1,54 @@
+name: Test install scripts
+
+on:
+  push:
+    branches:
+      - master
+    paths:
+      - 'docs/public/install.ps1'
+      - 'docs/public/install.sh'
+      - 'tests/test_install_script.py'
+      - 'tests/install_script.Tests.ps1'
+      - '.github/workflows/install_script_test.yml'
+  pull_request:
+    paths:
+      - 'docs/public/install.ps1'
+      - 'docs/public/install.sh'
+      - 'tests/test_install_script.py'
+      - 'tests/install_script.Tests.ps1'
+      - '.github/workflows/install_script_test.yml'
+  workflow_dispatch:
+
+jobs:
+  test:
+    name: Windows PowerShell compatibility
+    runs-on: windows-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v7
+
+      - name: Test Windows PowerShell 5.1
+        shell: powershell
+        run: .\tests\install_script.Tests.ps1
+
+      - name: Test PowerShell 7
+        shell: pwsh
+        run: .\tests\install_script.Tests.ps1
+
+  shell:
+    name: Bash installer (${{ matrix.os }})
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v7
+
+      - name: Test Bash installer
+        shell: bash
+        run: |
+          /bin/bash -n docs/public/install.sh
+          python3 tests/test_install_script.py

astrbot-4.29.3/Dockerfile

@@ -0,0 +1,41 @@
+FROM python:3.12-slim
+WORKDIR /AstrBot
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    gcc \
+    build-essential \
+    python3-dev \
+    libffi-dev \
+    libssl-dev \
+    ca-certificates \
+    bash \
+    ffmpeg \
+    libavcodec-extra \
+    fonts-noto-cjk \
+    curl \
+    gnupg \
+    git \
+    ripgrep \
+    && curl -fsSL https://deb.nodesource.com/setup_lts.x | bash - \
+    && apt-get install -y --no-install-recommends nodejs \
+    && apt-get clean \
+    && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*
+
+COPY . /AstrBot/
+
+# Bootstrap pip from the hash-verified wheel before downloading other packages.
+RUN python -m pip install --no-cache-dir \
+    "pip @ https://files.pythonhosted.org/packages/3f/06/3e4420302363fbb71be3c7f35ce042f54bfca330e3e66b3a2e3c4cca579f/pip-26.2.2-py3-none-any.whl#sha256=fd7f4dfa8190e014013b9f08f3e973f4e4c26ffd179a204895533a7254813a70" \
+    && python -m pip install --upgrade --no-cache-dir "uv>=0.13.4" \
+    && echo "3.12" > .python-version \
+    && uv lock \
+    && uv export --format requirements.txt --output-file requirements.txt --frozen \
+    && uv pip install -r requirements.txt --no-cache-dir --system \
+    && uv pip install socksio uv pilk --no-cache-dir --system \
+    && uv pip install --upgrade "certifi>=2026.10.19" "pip>=26.2.2" --no-cache-dir --system \
+    && uv pip install -e . --no-deps --system \
+    && touch /AstrBot/.astrbot
+
+EXPOSE 6185
+
+CMD ["python", "main.py"]

astrbot-4.29.3/PKG-INFO

@@ -0,0 +1,319 @@
+Metadata-Version: 2.5
+Name: AstrBot
+Version: 4.29.3
+Summary: Easy-to-use multi-platform LLM chatbot and development framework
+Project-URL: Repository, https://github.com/AstrBotDevs/AstrBot
+License: AGPL-3.0-or-later
+License-File: LICENSE
+Keywords: Agent,AstrBot,Chatbot,IM
+Requires-Python: >=3.12
+Requires-Dist: aiocqhttp>=1.4.4
+Requires-Dist: aiodocker>=0.24.0
+Requires-Dist: aiofiles>=25.1.0
+Requires-Dist: aiohttp>=3.11.18
+Requires-Dist: aiosqlite>=0.21.0
+Requires-Dist: anthropic>=0.51.0
+Requires-Dist: apscheduler>=3.11.0
+Requires-Dist: audioop-lts; python_full_version >= '3.13'
+Requires-Dist: certifi>=2026.10.19
+Requires-Dist: chardet~=5.1.0
+Requires-Dist: click>=8.2.1
+Requires-Dist: cryptography>=44.0.3
+Requires-Dist: dashscope>=1.23.2
+Requires-Dist: deprecated>=1.2.18
+Requires-Dist: dingtalk-stream>=0.22.1
+Requires-Dist: docstring-parser>=0.16
+Requires-Dist: faiss-cpu>=1.14.3
+Requires-Dist: fastapi>=0.124.0
+Requires-Dist: filelock>=3.18.0
+Requires-Dist: google-genai>=1.56.0
+Requires-Dist: httpx[socks]>=0.28.1
+Requires-Dist: jieba>=0.42.1
+Requires-Dist: lark-oapi>=1.4.15
+Requires-Dist: loguru>=0.7.2
+Requires-Dist: markitdown-no-magika[docx,xls,xlsx]>=0.1.2
+Requires-Dist: mcp<2,>=1.8.0
+Requires-Dist: openai>=1.78.0
+Requires-Dist: openpyxl>=3.1.5
+Requires-Dist: opentelemetry-api<2,>=1.45.1
+Requires-Dist: opentelemetry-sdk<2,>=1.45.1
+Requires-Dist: ormsgpack>=1.9.1
+Requires-Dist: packaging>=24.2
+Requires-Dist: pandas>=2.2.0
+Requires-Dist: pillow>=11.2.1
+Requires-Dist: pip>=26.2.2
+Requires-Dist: psutil<7.2.0,>=5.8.0
+Requires-Dist: py-cord>=2.6.1
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: pydub>=0.25.1
+Requires-Dist: pyjwt>=2.10.1
+Requires-Dist: pyotp>=2.9.0
+Requires-Dist: pypdf>=6.1.1
+Requires-Dist: pysocks>=1.7.1
+Requires-Dist: python-docx>=1.2.0
+Requires-Dist: python-ripgrep==0.0.8; python_version < '3.14'
+Requires-Dist: python-socks>=2.8.0
+Requires-Dist: python-telegram-bot>=22.6
+Requires-Dist: qq-botpy==1.2.1
+Requires-Dist: qrcode>=8.2
+Requires-Dist: quart>=0.20.0
+Requires-Dist: rank-bm25>=0.2.2
+Requires-Dist: reportlab>=5.0.0
+Requires-Dist: shipyard-neo-sdk>=0.2.0
+Requires-Dist: shipyard-python-sdk>=0.2.4
+Requires-Dist: silk-python>=0.2.6
+Requires-Dist: slack-sdk>=3.35.0
+Requires-Dist: sqlalchemy[asyncio]>=2.0.41
+Requires-Dist: sqlmodel>=0.0.24
+Requires-Dist: telegramify-markdown>=1.0.0
+Requires-Dist: tenacity>=9.1.2
+Requires-Dist: watchfiles>=1.0.5
+Requires-Dist: websockets>=15.0.1
+Requires-Dist: wechatpy>=1.8.18
+Requires-Dist: xinference-client
+Requires-Dist: xlrd>=2.0.2
+Description-Content-Type: text/markdown
+
+![AstrBot-Logo-Simplified](https://github.com/user-attachments/assets/36fb04e4-cc75-4454-bd8b-049d11aa86f9)
+
+
+<div align="center">
+
+<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_zh.md">简体中文</a> ｜
+<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_zh-TW.md">繁體中文</a> ｜
+<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_ja.md">日本語</a> ｜
+<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_fr.md">Français</a> ｜
+<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_es.md">Español</a> ｜
+<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_ru.md">Русский</a> 
+
+<br>
+
+<div>
+<a href="https://trendshift.io/repositories/21369" target="_blank"><img src="https://trendshift.io/api/badge/repositories/21369" alt="AstrBotDevs%2FAstrBot | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
+<a href="https://hellogithub.com/repository/AstrBotDevs/AstrBot" target="_blank"><img src="https://api.hellogithub.com/v1/widgets/recommend.svg?rid=d127d50cd5e54c5382328acc3bb25483&claim_uid=ZO9by7qCXgSd6Lp&t=2" alt="Featured｜HelloGitHub" style="width: 250px; height: 54px;" width="250" height="54" /></a>
+</div>
+
+<br>
+
+<div>
+<a href="https://github.com/AstrBotDevs/AstrBot/releases/latest"><img src="https://img.shields.io/github/v/release/AstrBotDevs/AstrBot?color=76bad9"></a>
+<a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/python-3.12+-blue.svg" alt="python"></a>
+<a href="https://deepwiki.com/AstrBotDevs/AstrBot"><img src="https://img.shields.io/badge/-Ask_DeepWiki-007ec6?logo=data%3Aimage%2Fpng%3Bbase64%2CiVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAACXBIWXMAAAPoAAAD6AG1e1JrAAACIUlEQVRYw%2B2XP2gUQRTGv7d3JhYWQawkIBaCVWzETos0gmAnVoKNTSoLK0E7EQQrC20sBVFBtLPQRgTBtBaKjYgIQUSxiJq7fT%2BLvCGPJZdNLt4dQj5Y3u7sznzfzLw%2Fs9IO%2FicANiniCujEfWdsQgBLxAbsbraPZcmBfcAt4DNwKQsZNfEUsAB8YRV12LfA6ZHuedg7AO7ed%2Fc%2BUBcbQhbiu%2B6wXIM6EnZWkszMJe2Ke0n6I2la0v51hFeSMLN6OwIK6jJwEBdUYb2MAxRSz6sY4geiahFgLe1Hwq6YWe3us8AN4FQQU4QM64SPY69Xyr43fADgNjAPXHb3peSsD4FDQ0VLEjAHvIhBPS6AHvA1bBO9JPAXcHFbIRtJ5yzwIQZ9CZwAusDJENIkLqsG8DpNyIZJwSUk9wLHgakcesC1JCCjiHm1kYDNOEjptCxpSVK%2F8f73OFLxPLAYM3oCzEX7MXf%2FlJbc%2F8kWpA4HgQdpYI9IWAbeh83whi84cHXL%2B58EPBoQhnmm94EzwE3gZ2p%2FDhzdbhg%2BTaRr01x7ftb4%2FjBwFzjXrCvDpmLW9crVLNeR9CaapoGemb2TdCERW1tNaBNQ8jktwmozqwtpqRNtdWAjARYk39IS12ZWRX7vmJmA71nQZgi36gN7gCvAj5xc3P0jcH7kx7Ik5IC73wsh14GZsZySow5002l4Jr0b6%2Bm4eSyvpAn8lEzsx2QHo8RfUrlN%2BuPq4ksAAAAASUVORK5CYII%3D&labelColor=000000"></a>
+<a href="https://zread.ai/AstrBotDevs/AstrBot" target="_blank"><img src="https://img.shields.io/badge/Ask_Zread-_.svg?style=flat&color=00b0aa&labelColor=000000&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTQuOTYxNTYgMS42MDAxSDIuMjQxNTZDMS44ODgxIDEuNjAwMSAxLjYwMTU2IDEuODg2NjQgMS42MDE1NiAyLjI0MDFWNC45NjAxQzEuNjAxNTYgNS4zMTM1NiAxLjg4ODEgNS42MDAxIDIuMjQxNTYgNS42MDAxSDQuOTYxNTZDNS4zMTUwMiA1LjYwMDEgNS42MDE1NiA1LjMxMzU2IDUuNjAxNTYgNC45NjAxVjIuMjQwMUM1LjYwMTU2IDEuODg2NjQgNS4zMTUwMiAxLjYwMDEgNC45NjE1NiAxLjYwMDFaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00Ljk2MTU2IDEwLjM5OTlIMi4yNDE1NkMxLjg4ODEgMTAuMzk5OSAxLjYwMTU2IDEwLjY4NjQgMS42MDE1NiAxMS4wMzk5VjEzLjc1OTlDMS42MDE1NiAxNC4xMTM0IDEuODg4MSAxNC4zOTk5IDIuMjQxNTYgMTQuMzk5OUg0Ljk2MTU2QzUuMzE1MDIgMTQuMzk5OSA1LjYwMTU2IDE0LjExMzQgNS42MDE1NiAxMy43NTk5VjExLjAzOTlDNS42MDE1NiAxMC42ODY0IDUuMzE1MDIgMTAuMzk5OSA0Ljk2MTU2IDEwLjM5OTlaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik0xMy43NTg0IDEuNjAwMUgxMS4wMzg0QzEwLjY4NSAxLjYwMDEgMTAuMzk4NCAxLjg4NjY0IDEwLjM5ODQgMi4yNDAxVjQuOTYwMUMxMC4zOTg0IDUuMzEzNTYgMTAuNjg1IDUuNjAwMSAxMS4wMzg0IDUuNjAwMUgxMy43NTg0QzE0LjExMTkgNS42MDAxIDE0LjM5ODQgNS4zMTM1NiAxNC4zOTg0IDQuOTYwMVYyLjI0MDFDMTQuMzk4NCAxLjg4NjY0IDE0LjExMTkgMS42MDAxIDEzLjc1ODQgMS42MDAxWiIgZmlsbD0iI2ZmZiIvPgo8cGF0aCBkPSJNNCAxMkwxMiA0TDQgMTJaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00IDEyTDEyIDQiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSIxLjUiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPgo8L3N2Zz4K&logoColor=ffffff" alt="zread"/></a>
+<a href="https://hub.docker.com/r/soulter/astrbot"><img alt="Docker pull" src="https://img.shields.io/docker/pulls/soulter/astrbot.svg?color=76bad9"/></a>
+<a href="https://cloud.astrbot.app/market"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.soulter.top%2Fastrbot%2Fplugin-num&query=%24.result&suffix=%20plugins&label=Marketplace&cacheSeconds=3600"></a>
+<a href="https://gitcode.com/Soulter/AstrBot"><img src="https://gitcode.com/Soulter/AstrBot/star/badge.svg"></a>
+</div>
+
+<br>
+
+<a href="https://astrbot.app/">Documentation</a> ｜
+<a href="https://blog.astrbot.app/">Blog</a> ｜
+<a href="https://astrbot.featurebase.app/roadmap">Roadmap</a> ｜
+<a href="https://github.com/AstrBotDevs/AstrBot/issues">Issue Tracker</a> ｜
+<a href="mailto:community@astrbot.app">Email Support</a>
+</div>
+
+AstrBot is an open-source all-in-one Agent chatbot platform that integrates with mainstream instant messaging apps. It provides reliable and scalable conversational AI infrastructure for individuals, developers, and teams. Whether you're building a personal AI companion, intelligent customer service, automation assistant, or enterprise knowledge base, AstrBot enables you to quickly build production-ready AI applications within your IM platform workflows.
+
+![screenshot_1 5x_postspark_2026-02-27_22-37-45](https://github.com/user-attachments/assets/f17cdb90-52d7-4773-be2e-ff64b566af6b)
+
+## Key Features
+
+1. 💯 Free & Open Source.
+2. ✨ AI LLM Conversations, Multimodal, Agent, MCP, Skills, Knowledge Base, Persona Settings, Auto Context Compression.
+3. 🤖 Supports integration with Dify, Alibaba Cloud Bailian, Coze, and other agent platforms.
+4. 🌐 Multi-Platform: QQ, WeChat Work, Feishu, DingTalk, WeChat Official Accounts, Telegram, Slack, and [more](#supported-messaging-platforms).
+5. 📦 Plugin Extensions with 1000+ plugins available for one-click installation.
+6. 🛡️ [Agent Sandbox](https://docs.astrbot.app/use/astrbot-agent-sandbox.html) for isolated, safe execution of code, shell calls, and session-level resource reuse.
+7. 💻 WebUI Support.
+8. 🌈 Web ChatUI Support with built-in agent sandbox and web search.
+9. 🌐 Internationalization (i18n) Support.
+
+## Quick Start
+
+### One-Click Cloud Deployment (RainYun)
+
+For users who want one-click 24-hour-online deployment and do not want to manage servers themselves, we recommend RainYun's one-click cloud deployment service ☁️:
+
+[![Deploy on RainYun](https://rainyun-apps.cn-nb1.rains3.com/materials/deploy-on-rainyun-en.svg)](https://app.rainyun.com/apps/rca/store/5994?ref=NjU1ODg0)
+
+### One-Click Deployment
+
+> [!NOTE]
+> Requires [uv](https://docs.astral.sh/uv/) to be installed.
+> For macOS users: due to macOS security checks, the first run of the `astrbot` command may take longer (about 10-20s).
+
+For users who want to quickly experience AstrBot, are familiar with command-line usage, and can install a `uv` environment on their own, we recommend the `uv` one-click deployment method ⚡️:
+
+```bash
+uv tool install astrbot --python 3.12
+astrbot init # Only execute this command for the first time to initialize the environment
+astrbot run
+```
+
+Update `astrbot`:
+
+```bash
+uv tool upgrade astrbot --python 3.12
+```
+
+### Docker Deployment
+
+For users familiar with containers and looking for a more stable, production-ready deployment method, we recommend deploying AstrBot with Docker / Docker Compose.
+
+Please refer to the official documentation: [Deploy AstrBot with Docker](https://docs.astrbot.app/deploy/astrbot/docker.html#%E4%BD%BF%E7%94%A8-docker-%E9%83%A8%E7%BD%B2-astrbot).
+
+### Desktop Application Deployment
+
+For users who want to use AstrBot on desktop and mainly use ChatUI, we recommend AstrBot App.
+
+Visit [AstrBot-desktop](https://github.com/AstrBotDevs/AstrBot-desktop) to download and install; this method is designed for desktop usage and is not recommended for server scenarios.
+
+### Launcher Deployment
+
+For desktop users who also want fast deployment and isolated multi-instance usage, we recommend AstrBot Launcher.
+
+Visit [AstrBot Launcher](https://github.com/Raven95676/astrbot-launcher) to download and install.
+
+**More deployment methods**
+
+If you need panel-based management or deeper customization, see [BT-Panel Deployment](https://docs.astrbot.app/deploy/astrbot/btpanel.html), [1Panel Deployment](https://docs.astrbot.app/deploy/astrbot/1panel.html), [CasaOS Deployment](https://docs.astrbot.app/deploy/astrbot/casaos.html), or [Source Deployment](https://docs.astrbot.app/deploy/astrbot/cli.html).
+
+
+## ❤️ Sponsors
+
+Welcome to sponsor us via [Afdian](https://afdian.com/a/astrbot_team) or [contact us](mailto:community@astrbot.app).
+
+<p align="center">
+  <a target="_blank" href="https://astrbot.app/#/sponsors">
+    <img alt="sponsors" src="https://sponsors.astrbot.app/?v=1">
+  </a>
+</p>
+
+
+## Supported Messaging Platforms
+
+Connect AstrBot to your favorite chat platform.
+
+| Platform | Maintainer |
+|---------|---------------|
+| QQ | Official |
+| OneBot v11 protocol implementation | Official |
+| Telegram | Official |
+| Wecom & Wecom AI Bot | Official |
+| WeChat Official Accounts | Official |
+| Feishu (Lark) | Official |
+| DingTalk | Official |
+| Slack | Official |
+| Discord | Official |
+| LINE | Official |
+| Satori | Official |
+| KOOK | Official |
+| Misskey | Official |
+| Mattermost | Official |
+| WhatsApp (Coming Soon) | Official |
+| [Matrix](https://github.com/stevessr/astrbot_plugin_matrix_adapter) | Community |
+| [Rocket.Chat](https://github.com/NET-Homeless/astrbot_plugin_rocket_chat_adapter) | Community |
+| [VoceChat](https://github.com/HikariFroya/astrbot_plugin_vocechat) | Community |
+
+## Supported Model Services
+
+| Service | Type |
+|---------|---------------|
+| OpenAI and Compatible Services | LLM Services |
+| Anthropic | LLM Services |
+| Google Gemini | LLM Services |
+| Moonshot AI | LLM Services |
+| Zhipu AI | LLM Services |
+| DeepSeek | LLM Services |
+| Ollama (Self-hosted) | LLM Services |
+| LM Studio (Self-hosted) | LLM Services |
+| [MiraRouter](https://mirarouter.com/) | LLM Services (API Gateway, supports all models) |
+| [AIHubMix](https://aihubmix.com/?aff=4bfH) | LLM Services (API Gateway, supports all models) |
+| [CompShare](https://www.compshare.cn/?ytag=GPU_YY-gh_astrbot&referral_code=FV7DcGowN4hB5UuXKgpE74) | LLM Services |
+| [302.AI](https://share.302.ai/rr1M3l) | LLM Services |
+| [TokenPony](https://www.tokenpony.cn/3YPyf) | LLM Services |
+| [SiliconFlow](https://docs.siliconflow.cn/cn/usercases/use-siliconcloud-in-astrbot) | LLM Services |
+| [PPIO Cloud](https://ppio.com/user/register?invited_by=AIOONE) | LLM Services |
+| ModelScope | LLM Services |
+| OneAPI | LLM Services |
+| Dify | LLMOps Platforms |
+| Alibaba Cloud Bailian Applications | LLMOps Platforms |
+| Coze | LLMOps Platforms |
+| OpenAI Whisper | Speech-to-Text Services |
+| SenseVoice | Speech-to-Text Services |
+| Xiaomi MiMo Omni | Speech-to-Text Services |
+| OpenAI TTS | Text-to-Speech Services |
+| Gemini TTS | Text-to-Speech Services |
+| GPT-Sovits-Inference | Text-to-Speech Services |
+| GPT-Sovits | Text-to-Speech Services |
+| FishAudio | Text-to-Speech Services |
+| Edge TTS | Text-to-Speech Services |
+| Alibaba Cloud Bailian TTS | Text-to-Speech Services |
+| Azure TTS | Text-to-Speech Services |
+| Minimax TTS | Text-to-Speech Services |
+| Xiaomi MiMo TTS | Text-to-Speech Services |
+| Volcano Engine TTS | Text-to-Speech Services |
+
+## ❤️ Contributing
+
+Issues and Pull Requests are always welcome! Feel free to submit your changes to this project :)
+
+### How to Contribute
+
+You can contribute by reviewing issues or helping with pull request reviews. Any issues or PRs are welcome to encourage community participation. Of course, these are just suggestions—you can contribute in any way you like. For adding new features, please discuss through an Issue first.
+
+### Development Environment
+
+AstrBot uses `ruff` for code formatting and linting.
+
+```bash
+git clone https://github.com/AstrBotDevs/AstrBot
+pip install pre-commit
+pre-commit install
+```
+
+
+## 🌍 Community
+
+### QQ Groups
+
+We have 15+ chat groups, please see: [Community](https://docs.astrbot.app/community.html) for details.
+
+### Discord Server
+
+<a href="https://discord.gg/hAVk6tgV36"><img alt="Discord_community" src="https://img.shields.io/badge/Discord-AstrBot-purple?style=for-the-badge&color=76bad9"></a>
+
+## ❤️ Special Thanks
+
+Special thanks to all Contributors and plugin developers for their contributions to AstrBot ❤️
+
+<a href="https://github.com/AstrBotDevs/AstrBot/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=AstrBotDevs/AstrBot&max=300&columns=15" />
+</a>
+
+Open Source Friends ❤️
+
+- [NapNeko/NapCatQQ](https://github.com/NapNeko/NapCatQQ) - The amazing cat framework
+- [Mai-with-u/MaiBot](https://github.com/Mai-with-u/MaiBot) - The powerful "digital life" in your QQ! 
+
+## ⭐ Star History
+
+> [!TIP]
+> If this project has helped you in your life or work, or if you're interested in its future development, please give the project a Star. It's the driving force behind maintaining this open-source project <3
+
+<div align="center">
+
+[![Star History Chart](https://api.star-history.com/svg?repos=astrbotdevs/astrbot&type=Date)](https://star-history.com/#astrbotdevs/astrbot&Date)
+
+</div>
+
+<div align="center">
+
+_Companionship and capability should never be at odds. What we aim to create is a robot that can understand emotions, provide genuine companionship, and reliably accomplish tasks._
+
+_私は、高性能ですから!_
+
+<img src="https://files.astrbot.app/watashiwa-koseino-desukara.gif" width="100"/>
+</div>