Skip to content

docs: Add FAQ section for common questions#8278

Open
meichuanyi wants to merge 1 commit into
AstrBotDevs:masterfrom
meichuanyi:docs-faq-34872
Open

docs: Add FAQ section for common questions#8278
meichuanyi wants to merge 1 commit into
AstrBotDevs:masterfrom
meichuanyi:docs-faq-34872

Conversation

@meichuanyi
Copy link
Copy Markdown

@meichuanyi meichuanyi commented May 21, 2026

Summary

Added a comprehensive FAQ section to help users quickly understand the project and get started.

FAQ Content

  • What is this project?
  • Key Features and comparison with alternatives
  • Supported LLM providers
  • Getting started guide
  • License information
  • Help resources

Checklist

  • Documentation improvement
  • No code changes
  • Quality content that adds value

Summary by Sourcery

Documentation:

  • Add an FAQ section to the README covering project overview, key features, getting started, LLM providers, licensing, and help resources.

@dosubot dosubot Bot added the size:M This PR changes 30-99 lines, ignoring generated files. label May 21, 2026
Copy link
Copy Markdown
Contributor

@sourcery-ai sourcery-ai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey - I've reviewed your changes and they look great!


Sourcery is free for open source - if you like our reviews please consider sharing them ✨
Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

The pull request updates project badges and adds a new FAQ section to the README. Feedback focuses on maintaining consistency by synchronizing these updates across localized README files and ensuring the FAQ content aligns with existing information regarding supported features and LLM providers.

Comment thread README.md

<div>
<a href="https://trendshift.io/repositories/12875" target="_blank"><img src="https://trendshift.io/api/badge/repositories/12875" alt="Soulter%2FAstrBot | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
<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>
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The repository ID and name in the Trendshift badge have been updated here, but they remain unchanged in the localized README files (e.g., README_zh.md line 12, README_ja.md line 14). Additionally, the contributor badge parameters on line 261 have been updated only in this file. Please synchronize these changes across all README versions to ensure consistent branding and statistics.

Comment thread README.md
<img src="https://files.astrbot.app/watashiwa-koseino-desukara.gif" width="100"/>
</div>

## FAQ (Frequently Asked Questions)
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

This new FAQ section provides valuable information but is currently only added to the English README. To ensure that users of all supported languages benefit from this content, please consider adding and translating this section in the localized README files (README_zh.md, README_ja.md, etc.).

Comment thread README.md
Comment on lines +294 to +315
### Key Features

| Feature | Description |
|---------|-------------|
| 🆓 Free & Open Source | MIT-licensed, community-driven |
| 🤖 AI Conversations | LLM, multimodal, Agent, MCP, Skills, Knowledge Base |
| 🌐 Multi-Platform | QQ, WeChat Work, Feishu, DingTalk, Telegram, Slack |
| 📦 1000+ Plugins | One-click installation |
| 🛡️ Agent Sandbox | Safe code execution |
| 💻 WebUI & ChatUI | Web interfaces |

### Getting Started

```bash
uv tool install astrbot --python 3.12
astrbot init
astrbot run
```

### LLM Providers

OpenAI, Anthropic, Google Gemini, DeepSeek, Alibaba Cloud Bailian, Moonshot, MiniMax, StepFun, Ollama, vLLM.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The 'Key Features' table and 'LLM Providers' list in this FAQ section are inconsistent with the main sections of the README. For example, the features table (line 300) omits 'WeChat Official Accounts' (listed on line 49), and the LLM list (line 315) contains providers like StepFun and vLLM that are missing from the main 'Supported Model Services' table (lines 173-188). Please ensure the FAQ accurately reflects the full capabilities and integrations described elsewhere in the document.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size:M This PR changes 30-99 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant