소개
AstrBot Launcher는 AstrBot 에이전트 챗봇 플랫폼을 그래픽적으로 관리하고 다중 인스턴스를 손쉽게 설정·업데이트·백업할 수 있는 Windows 데스크톱 애플리케이션입니다.
상세정보
소개
AstrBot Launcher는 AstrBot 에이전트 챗봇 플랫폼을 그래픽적으로 관리하고 다중 인스턴스를 손쉽게 설정·업데이트·백업할 수 있는 Windows 데스크톱 애플리케이션입니다. 사용자는 별도의 명령어 없이 GUI를 통해 AstrBot 인스턴스를 생성, 시작, 중지, 업그레이드하고 데이터를 백업·복구할 수 있습니다.
핵심 기능
- 제로 인트루전 아키텍처: 실행 환경과 의존성을 독립 디렉터리에 관리하여 시스템 오염 방지
- 다중 인스턴스 시각적 관리: 생성·시작·중지·업그레이드를 한 번에 수행
- 안전 백업 및 복구: 인스턴스 수준의 백업·복구로 데이터 안전성 확보
- 실행 시 격리: 인스턴스 간 환경 충돌 방지
- 데스크톱 친화적 통합: 트레이 거주, 시작 시 자동 실행으로 바로 사용 가능
지원 환경
Windows 10 이상 (x86, x64, ARM64)에서 PowerShell과 Python 3.10~3.13이 PATH에 등록된 경우 정상 동작합니다. Windows ARM64에서는 시스템 에뮬레이션 계층을 통해 x86_64 Python을 사용합니다.
기본 사용법
- 공식 저장소에서 최신 릴리스의
AstrBot.Launcher_<version>_<arch>-setup.exe파일을 다운로드합니다. - 설치 프로그램을 실행하여 AstrBot Launcher를 설치합니다 (설치 과정은 약 20KB의 PowerShell 부트스트래퍼가 실행됩니다).
- 설치 후 시작 메뉴 또는 트레이 아이콘에서 AstrBot Launcher를 실행합니다.
- ‘새 인스턴스’ 버튼을 클릭하고 원하는 AstrBot 버전을 선택하여 인스턴스를 생성합니다.
- 인스턴스 목록에서 시작·중지·업그레이드·백업 등을 수행합니다.
제한 사항 및 체크포인트
- Windows ARM64에서 DLL 로드 오류가 발생할 경우, greenlet 라이브러리가 포함된 런타임을 설치해야 합니다 (에러 메시지:
ValueError: the greenlet library is required to use this function. DLL load failed while importing _greenlet: The specified module could not be found.). - Python이 PATH에 제대로 등록되지 않은 경우 설치 프로그램이 정상 작동하지 않으며, 환경 변수를 수동으로 설정하거나 Python을 다시 설치하면서 ‘Add Python to PATH’ 옵션을 활성화해야 합니다.
- macOS에서는 현재 이론적으로만 작동하며 충분한 실기 검증이 부족합니다.
FAQ
- 다운로드가 느리거나 네트워크 오류가 발생하면 어떻게 하나요? 소프트웨어 페이지 왼쪽의 ‘고급’ 버튼을 클릭해 프록시 또는 소스를 설정하거나, ‘중국대륙 한 번 가속’ 기능을 이용해 대부분의 문제를 해결할 수 있습니다.
- WebUI는 어떤 주소에서 listening 하나요? v0.3.4 이후 버전부터 인스턴스는 기본적으로
127.0.0.1(IPv4 루프백)에서만 수신하며, 필요 시 설정에서::1,0.0.0.0,::또는 사용자 지정 주소로 변경할 수 있습니다. - Linux에서는 어떤 수준의 지원을 받을 수 있나요? 코드 상으로는 호환되지만 다양한 데스크톱 환경 간 차이로 인해 ‘최선의 노력’ 수준의 지원만 제공됩니다.
화면으로 보는 주요 기능
AstrBot 로고 화면
AstrBot 로고와 함께 파란색 별 모양 아이콘과 작은 더하기 기호가 보입니다. 오른쪽에는 'AstrBot'이라는 텍스트와 그 아래에 'https://astrbot.app'라는 웹사이트 주소가 표시되어 있습니다.
시스템 요구사항
Windows 10 이상 (x86, x64, ARM64), PowerShell (기본 포함), Python 3.10~3.13 및 PATH 환경 변수에 등록 필요. Windows ARM64에서는 x86_64 Python을 에뮬레이션 레이어를 통해 사용합니다.