AstrBot-Android-App  by zz6zz666

Your QQ number as an AI chatbot on Android

Created 7 months ago
258 stars

Top 97.9% on SourcePulse

GitHubView on GitHub
Project Summary

AstrBot Android App provides a simplified, mobile-first solution for individuals to transform their personal QQ accounts into AI-powered chatbots. It targets non-technical users, enabling them to leverage advanced AI models for automated conversations and interactions within QQ without requiring a PC, command-line expertise, or server setup. The app offers a user-friendly experience, making sophisticated AI chatbot technology accessible to a broad audience.

How It Works

This application encapsulates the powerful AstrBot framework and the NapCatQQ QQ protocol adapter within a single Android package. It bundles a complete Ubuntu container environment, automatically handling the complex setup and dependencies. Users install an APK, log into their QQ account via QR code, and configure their preferred Large Language Model (LLM) API keys through an in-app web interface. This approach abstracts away all technical complexities, allowing for a seamless, mobile-native deployment of a personal AI assistant.

Quick Start & Requirements

  • Primary install: Download and install the .apk file from the GitHub releases page or the 123 Cloud Disk share.
  • Prerequisites: An Android phone or tablet, a stable internet connection for initial setup, and a QQ account.
  • Dependencies: All necessary components (Ubuntu container, AstrBot core, NapCatQQ) are bundled within the APK.
  • Setup Time: Initial setup involves downloading resources and can take time; monitoring logs during initialization is recommended. Post-setup configuration involves QQ login and LLM API key entry.
  • Documentation: AstrBot Official Docs

Highlighted Details

  • QQ Account Transformation: Converts a personal QQ number into an AI chatbot capable of one-on-one and group interactions.
  • LLM Integration: Supports connecting to various LLMs, including OpenAI, Gemini, Llama, Dify, and domestic Chinese platforms, via API keys.
  • Plugin Support: Enables official plugins for features like translation, web search, and conversation memory.
  • Mobile Management: All configuration, including LLM settings and plugin management, is accessible via an in-app WebView dashboard.

Maintenance & Community

  • Community: Users can provide feedback and report issues via GitHub Issues. A QQ feedback group is available at 777156380.
  • Core Dependencies: Relies on the ongoing development of AstrBot and NapCatQQ.

Licensing & Compatibility

  • License: BSD-3-Clause.
  • Compatibility: Designed exclusively for Android devices. Primarily targets personal QQ accounts; compatibility with other platforms like WeChat or Telegram is not supported in this app version. The BSD-3-Clause license generally permits commercial use and linking.

Limitations & Caveats

The app is strictly limited to QQ personal accounts and does not support other messaging platforms. Advanced features like the code execution sandbox are not available due to the Android environment. Initial setup requires a stable network and careful monitoring, as interruptions can lead to failures necessitating a full data reset and re-initialization. The app requires notification permissions to run reliably in the background.

Health Check
Last Commit

7 months ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
4
Star History
52 stars in the last 30 days

Explore Similar Projects

Starred by Sebastian Raschka Sebastian Raschka(Author of "Build a Large Language Model (From Scratch)"), Pawel Garbacki Pawel Garbacki(Cofounder of Fireworks AI), and
16 more.

chainlit by Chainlit

0.2%
12k
Framework for rapid conversational AI app development
Created 3 years ago
Updated 3 weeks ago
Feedback? Help us improve.