KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

AstrBot

★ 39,256 Open GitHub ↗

수많은 IM 플랫폼, LLM, 플러그인, AI 기능을 통합하여 openclaw의 대안이 될 수 있는 AI Agent Assistant 및 개발 프레임워크입니다. ✨

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![AstrBot-Logo-Simplified](https://github.com/user-attachments/assets/36fb04e4-cc75-4454-bd8b-049d11aa86f9)

[简体中文](https://github.com/AstrBotDevs/AstrBot/blob/master/README_zh.md) ｜
[繁體中文](https://github.com/AstrBotDevs/AstrBot/blob/master/README_zh-TW.md) ｜
[日本語](https://github.com/AstrBotDevs/AstrBot/blob/master/README_ja.md) ｜
[Français](https://github.com/AstrBotDevs/AstrBot/blob/master/README_fr.md) ｜
[Español](https://github.com/AstrBotDevs/AstrBot/blob/master/README_es.md) ｜
[Русский](https://github.com/AstrBotDevs/AstrBot/blob/master/README_ru.md)

[![AstrBotDevs%2FAstrBot | Trendshift](https://trendshift.io/api/badge/repositories/21369)](https://trendshift.io/repositories/21369)
[![Featured｜HelloGitHub](https://api.hellogithub.com/v1/widgets/recommend.svg?rid=d127d50cd5e54c5382328acc3bb25483&claim_uid=ZO9by7qCXgSd6Lp&t=2)](https://hellogithub.com/repository/AstrBotDevs/AstrBot)

![](https://img.shields.io/github/v/release/AstrBotDevs/AstrBot?color=76bad9)
![python](https://img.shields.io/badge/python-3.12+-blue.svg)
![](https://deepwiki.com/badge.svg)
[![zread](https://img.shields.io/badge/Ask_Zread-_.svg?style=flat&color=00b0aa&labelColor=000000&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTQuOTYxNTYgMS42MDAxSDIuMjQxNTZDMS44ODgxIDEuNjAwMSAxLjYwMTU2IDEuODg2NjQgMS42MDE1NiAyLjI0MIVWNC45NjAxQzEuNjAxNTYgNS4zMTM1NiAxLjg4ODEgNS42MDAxIDIuMjQxNTYgNS42MDAxSDQuOTYxNTZDNS4zMTUwMiA1LjYwMDEgNS42MDE1NiA1LjMxMzU2IDUuNjAxNTYgNC45NjAxVjIuMjQwMUM1LjYwMTU2IDEuODg2NjQgNS4zMTUwMiAxLjYwMDEgNC45NjE1NiAxLjYwMDFaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00Ljk2MTU2IDEwLjM5OTlIMi4yNDE1NkMxLjg4ODEgMTAuMzk5OSAxLjYwMTU2IDEwLjY4NjQgMS42MDE1NiAxMS4wMzk5VjEzLjc1OTlDMS42MDE1NiAxNC4xMTM0IDEuODg4MSAxNC4zOTk5IDIuMjQxNTYgMTQuMzk5OUg0Ljk2MTU2QzUuMzE1MDIgMTQuMzk5OSA1LjYwMTU2IDE0LjExMzQgNS42MDE1NiAxMy43NTk5VjExLjAzOTlDNS42MDE1NiAxMC42ODY0IDUuMzE1MDIgMTAuMzk5OSA0Ljk2MTU2IDEwLjM5OTlaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik0xMy43NTg0IDEuNjAwMUgxMS4wMzg0QzEwLjY4NSAxLjYwMDEgMTAuMzk4NCAxLjg4NjY0IDEwLjM5ODQgMi4yNDAxVjQuOTYwMUMxMC4zOTg0IDUuMzEzNTYgMTAuNjg1IDUuNjAwMSAxMS4wMzg0IDUuNjAwMUgxMy43NTg0QzE0LjExMTkgNS42MDAxIDE0LjM5ODQgNS4zMTM1NiAxNC4zOTg0IDQuOTYwMVYyLjI0MDFDMTQuMzk4NCAxLjg4NjY0IDE0LjExMTkgMS42MDAxIDEzLjc1ODQgMS42MDAxWiIgZmlsbD0iI2ZmZiIvPgo8cGF0aCBkPSJNNCAxMkwxMiA0TDQgMTJaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00IDEyTDEyIDQiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSIxLjUiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPgo8L3N2Zz4K&logoColor=ffffff)](https://zread.ai/AstrBotDevs/AstrBot)
[![Docker pull](https://img.shields.io/docker/pulls/soulter/astrbot.svg?color=76bad9)](https://hub.docker.com/r/soulter/astrbot)
![](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)
![](https://gitcode.com/Soulter/AstrBot/star/badge.svg)

[Documentation](https://astrbot.app/) ｜
[Blog](https://blog.astrbot.app/) ｜
[Roadmap](https://astrbot.featurebase.app/roadmap) ｜
[Issue Tracker](https://github.com/AstrBotDevs/AstrBot/issues) ｜
[Email Support](mailto:community@astrbot.app)

AstrBot은 주요 인스턴트 메신저 앱과 연동되는 오픈소스 올인원 Agent 챗봇 플랫폼입니다. 개인, 개발자, 그리고 팀을 위해 안정적이고 확장 가능한 대화형 AI 인프라를 제공합니다. 개인용 AI 컴패니언, 지능형 고객 센터, 자동화 어시스턴트, 엔터프라이즈 지식 베이스 중 무엇을 구축하든, AstrBot을 사용하면 IM 플랫폼 워크플로우 내에서 프로덕션 수준의 AI 애플리케이션을 빠르게 구축할 수 있습니다.
![screenshot\_1 5x\_postspark\_2026-02-27\_22-37-45](https://github.com/user-attachments/assets/f17cdb90-52d7-4773-be2e-ff64b566af6b)
## 주요 기능 (Key Features)
1. 💯 무료 및 오픈소스.
2. ✨ AI LLM 대화, 멀티모달, Agent, MCP, Skills, 지식 베이스, 페르소나 설정, 자동 컨텍스트 압축.
3. 🤖 Dify, Alibaba Cloud Bailian, Coze 및 기타 에이전트 플랫폼과의 연동 지원.
4. 🌐 멀티 플랫폼: QQ, WeChat Work, Feishu, DingTalk, WeChat Official Accounts, Telegram, Slack 및 [기타 플랫폼](#supported-messaging-platforms).
5. 📦 1,000개 이상의 플러그인을 원클릭으로 설치할 수 있는 플러그인 확장 기능.
6. 🛡️ 코드, 셸 호출 및 세션 수준 리소스 재사용을 안전하게 격리하여 실행할 수 있는 [Agent Sandbox](https://docs.astrbot.app/use/astrbot-agent-sandbox.html).
7. 💻 WebUI 지원.
8. 🌈 에이전트 샌드박스 및 웹 검색이 내장된 Web ChatUI 지원.
9. 🌐 국제화(i18n) 지원.

| 💙 역할극 및 감정적 교감 | ✨ 프로액티브 에이전트 | 🚀 일반 에이전트 역량 | 🧩 1000개 이상의 커뮤니티 플러그인 |
| --- | --- | --- | --- |
| 99b587c5d35eea09d84f33e6cf6cfd4f | c449acd838c41d0915cc08a3824025b1 | image | image |

## 빠른 시작 (Quick Start)
### 원클릭 배포
> [!NOTE]
> [uv](https://docs.astral.sh/uv/)가 설치되어 있어야 합니다.
> macOS 사용자 참고: macOS 보안 검사로 인해 `astrbot` 명령을 처음 실행할 때 시간이 다소 걸릴 수 있습니다(약 10~20초).
AstrBot을 빠르게 체험해보고 싶고, 커맨드 라인 사용에 익숙하며, 직접 `uv` 환경을 설치할 수 있는 사용자에게는 `uv` 원클릭 배포 방법을 추천합니다 ⚡️:
```bash
uv tool install astrbot --python 3.12
astrbot init # 환경 초기화를 위해 최초 1회만 실행하세요
astrbot run
```
`astrbot` 업데이트:
```bash
uv tool upgrade astrbot --python 3.12
```
### 클라우드 원클릭 배포 (RainYun)
서버를 직접 관리하지 않고 원클릭으로 배포하려는 사용자를 위해 RainYun의 클라우드 원클릭 배포 서비스를 추천합니다 ☁️:
[![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)
### Docker 배포
컨테이너에 익숙하고 더 안정적인 프로덕션 수준의 배포 방법을 찾는 사용자에게는 Docker / Docker Compose를 사용한 AstrBot 배포를 추천합니다.
공식 문서를 참고하세요: [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).
### 데스크톱 애플리케이션 배포
데스크톱에서 AstrBot을 사용하고 싶고 주로 ChatUI를 이용하려는 사용자에게는 AstrBot App을 추천합니다.
[AstrBot-desktop](https://github.com/AstrBotDevs/AstrBot-desktop)을 방문하여 다운로드 및 설치하세요. 이 방법은 데스크톱 사용을 위해 설계되었으며 서버 환경에는 권장되지 않습니다.
### 런처 배포
빠른 배포와 격리된 멀티 인스턴스 사용을 원하는 데스크톱 사용자에게는 AstrBot Launcher를 추천합니다.
[AstrBot Launcher](https://github.com/Raven95676/astrbot-launcher)를 방문하여 다운로드 및 설치하세요.
### Replit에 배포
Replit 배포는 커뮤니티에서 유지 관리하며 온라인 데모 및 가벼운 체험에 적합합니다.
[![Run on Repl.it](https://repl.it/badge/github/AstrBotDevs/AstrBot)](https://repl.it/github/AstrBotDevs/AstrBot)
### AUR
AUR 배포는 시스템 패키지 워크플로우를 통해 AstrBot을 설치하려는 Arch Linux 사용자를 대상으로 합니다.
아래 명령을 실행하여 `astrbot-git`을 설치한 후, 로컬 환경에서 AstrBot을 시작하세요.
```bash
yay -S astrbot-git
```
\*\*기타 배포 방법\*\*
패널 기반 관리나 더 깊은 커스텀이 필요한 경우, BT 패널 앱스토어 설정을 위한 [BT-Panel Deployment](https://docs.astrbot.app/deploy/astrbot/btpanel.html), 1Panel 앱 마켓 배포를 위한 [1Panel Deployment](https://docs.astrbot.app/deploy/astrbot/1panel.html), NAS/홈 서버 시각적 배포를 위한 [CasaOS Deployment](https://docs.astrbot.app/deploy/astrbot/casaos.html), 그리고 `uv`를 사용한 완전 맞춤형 소스 기반 설치를 위한 [Manual Deployment](https://docs.astrbot.app/deploy/astrbot/cli.html)를 참고하세요.

## ❤️ 후원자 (Sponsors)
[Afdian](https://afdian.com/a/astrbot\_team)을 통해 후원하시거나 [이메일로 문의](mailto:community@astrbot.app)해 주세요.

[![sponsors](https://sponsors.astrbot.app/?v=1)](https://astrbot.app/#/sponsors)

## 지원하는 메시징 플랫폼 (Supported Messaging Platforms)
원하는 채팅 플랫폼에 AstrBot을 연결하세요.
| 플랫폼 | 관리자 |
|---------|---------------|
| 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 (출시 예정) | 공식 (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)
| 서비스 | 유형 |
|---------|---------------|
| OpenAI 및 호환 서비스 | LLM Services |
| Anthropic | LLM Services |
| Google Gemini | LLM Services |
| Moonshot AI | LLM Services |
| Zhipu AI | LLM Services |
| DeepSeek | LLM Services |
| Ollama (자체 호스팅) | LLM Services |
| LM Studio (자체 호스팅) | LLM Services |
| [AIHubMix](https://aihubmix.com/?aff=4bfH) | LLM Services (API Gateway, 모든 모델 지원) |
| [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)
이슈(Issue)와 풀 리퀘스트(PR)는 언제나 환영합니다! 변경 사항을 자유롭게 제출해 주세요 :)
### 기여 방법
이슈 검토나 풀 리퀘스트 리뷰를 통해 기여할 수 있습니다. 커뮤니티 참여를 독려하기 위해 어떤 이슈나 PR이든 환영합니다. 물론 이는 제안일 뿐이며, 원하시는 어떤 방식으로든 기여하실 수 있습니다. 새로운 기능을 추가하는 경우, 먼저 이슈를 통해 논의해 주세요.
### 개발 환경
AstrBot은 코드 포맷팅 및 린팅을 위해 `ruff`를 사용합니다.
```bash
git clone https://github.com/AstrBotDevs/AstrBot
pip install pre-commit
pre-commit install
```

## 🌍 커뮤니티 (Community)
### QQ 그룹
15개 이상의 채팅 그룹이 있습니다. 자세한 내용은 [Community](https://docs.astrbot.app/community.html)를 참고하세요.
### Discord 서버
[![Discord_community](https://img.shields.io/badge/Discord-AstrBot-purple?style=for-the-badge&color=76bad9)](https://discord.gg/hAVk6tgV36)

## ❤️ 특별히 감사한 분들 (Special Thanks)
AstrBot에 기여해 주신 모든 기여자(Contributor)와 플러그인 개발자분들께 진심으로 감사드립니다 ❤️
[![](https://contrib.rocks/image?repo=AstrBotDevs/AstrBot&max=300&columns=15)](https://github.com/AstrBotDevs/AstrBot/graphs/contributors)

오픈소스 친구들 ❤️
- [NapNeko/NapCatQQ](https://github.com/NapNeko/NapCatQQ) - 놀라운 캣 프레임워크
- [Mai-with-u/MaiBot](https://github.com/Mai-with-u/MaiBot) - QQ 속 강력한 "디지털 라이프"!

## ⭐ Star History
> [!TIP]
> 이 프로젝트가 여러분의 삶이나 업무에 도움이 되었거나 향후 개발에 관심이 있으시다면 프로젝트에 Star를 눌러주세요. 오픈소스 프로젝트를 유지하는 가장 큰 원동력입니다 <3

[![Star History Chart](https://api.star-history.com/svg?repos=astrbotdevs/astrbot&type=Date)](https://star-history.com/#astrbotdevs/astrbot&Date)

\_감정적 교감과 뛰어난 성능은 결코 상충되지 않습니다. 우리가 만들고자 하는 것은 감정을 이해하고 진정한 교감을 나누며, 믿음직하게 작업을 수행할 수 있는 로봇입니다.\_
\_私は、高性能ですから!\_
![](https://files.astrbot.app/watashiwa-koseino-desukara.gif)

AstrBot

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README