QuecPython AI Chatbot Based on Xiaozhi Platform

Table of Contents

• Introduction
• Features
• Quick_Start
  • Prerequisites
  • Installation
  • Running_Application
• Contributing
• License
• Support

Introduction

QuecPython introduces the Xiaozhi Platform AI Chatbot solution. This solution is based on the WebSocket protocol, offering cross-platform compatibility and supporting most QuecPython modules.

This demo uses an AI development board equipped with the EC800MCNLE module.

Features

• Supports voice interruption/barge-in.
• Supports keyword-based voice wake-up.
• Uses Python for easy secondary development.

Quick_Start

Prerequisites

Before getting started, ensure you have the following prerequisites:

• Hardware:
  • Contact Quectel to obtain the AI development board and accessories.
  • Computer (Windows 7, Windows 10, or Windows 11)
  • Speaker
    • Any 2-5W speaker will work
    • Purchase link from Quectel Mall
• Software:
  • Debugging tool QPYcom
  • QuecPython firmware (beta firmware is available in the fw directory of the repository)
  • Python text editor (e.g., VSCode, PyCharm)

Installation

1. Clone the Repository:

   git clone https://github.com/QuecPython/AIBox 

2. Flash the Firmware: Follow the instructions to flash the firmware onto the development board.

Running_Application

1. Hardware Connection: This demo uses the Quectel AI development board. Contact Quectel if needed. Connect the hardware as shown below:

   

   Connect to the host computer via Type-C.

2. Download the Code to the Device:

   • Launch the QPYcom debugging tool.
   • Connect the data cable to the computer.
   • Press the PWRKEY button on the development board to power on the device.
   • Follow the instructions to import all files from the code folder into the module's file system, preserving the directory structure.

3. Run the Application:

   • Select the File tab.
   • Choose the _main.py script.
   • Right-click and select Run or use the Run shortcut button to execute the script.

4. After keyword wake-up, start a conversation. Refer to the runtime log:

   

5. For a usage example, refer to the demo video: You can go to the media file under this folder to view the usage sample video by yourself

Contributing

We welcome contributions to improve this project! Follow these steps to contribute:

1. Fork this repository.
2. Create a new branch (git checkout -b feature/your-feature).
3. Commit your changes (git commit -m 'Add your feature').
4. Push to the branch (git push origin feature/your-feature).
5. Open a Pull Request.

License

This project is licensed under the Apache License. See the LICENSE file for details.

Support

If you have any questions or need support, refer to the QuecPython Documentation or open an issue in this repository.