charmbracelet/bubbletea

어떤 프로젝트인가요?

핵심 기능

• 01모델의 Init, Update, View 메서드로 The Elm Architecture를 구현합니다.
• 02셀 기반 렌더러와 내장 색상 다운샘플링을 제공합니다.
• 03인라인, 전체 화면, 혼합 터미널 레이아웃을 지원합니다.
• 04키보드와 마우스 입력 처리 및 네이티브 클립보드 접근을 지원합니다.
• 05타이머나 요청 같은 비동기 I/O를 위한 명령 시스템을 제공합니다.

활용 사례

• Go로 폼, 목록, 메뉴가 있는 대화형 명령줄 도구를 만들 때.
• 전체 화면 터미널 대시보드나 파일 관리자를 만들 때.
• 입력 이벤트에 반응하는 터미널 게임이나 시각화를 작성할 때.

빠른 시작

1. 1

   Go 코드에서 Bubble Tea v2 패키지를 가져옵니다

2. 2

   bubbletea와 해당 종속성을 다운로드합니다

   go mod tidy

사용 전 알아둘 점

• !Go로 작성되어 있으므로 사용하려면 Go에 대한 실무 지식이 필요합니다.
• !v2에서 API가 변경되었으므로 v1에서 업그레이드하려면 별도의 업그레이드 가이드를 따라야 합니다.

토픽

자주 묻는 질문

bubbletea은(는) 무엇인가요?

The Elm Architecture의 모델-업데이트-뷰 패턴을 사용해 터미널 UI를 만드는 Go 프레임워크입니다. Bubble Tea는 간단한 대화형 도구부터 대형 전체 화면 프로그램까지, 터미널 애플리케이션을 만들기 위한 Go 프레임워크입니다. The Elm Architecture를 따르며, 애플리케이션은 상태를 담는 모델, 키 입력 등의 메시지를 처리하는 Update 함수, 그리고 상태를 바탕으로 인터페이스를 렌더링하는 View 함수로 구성됩니다. 런타임이 화면을 다시 그리는 작업을 처리하므로, 개발자는 터미널 출력을 직접 관리하는 대신 UI를 정의하면 됩니다.

bubbletea은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

bubbletea은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

bubbletea은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. bubbletea의 마지막 커밋은 2026년 10월 8일입니다.

bubbletea은(는) 어디에 사용할 수 있나요?

Go로 폼, 목록, 메뉴가 있는 대화형 명령줄 도구를 만들 때. 전체 화면 터미널 대시보드나 파일 관리자를 만들 때. 입력 이벤트에 반응하는 터미널 게임이나 시각화를 작성할 때.

bubbletea는 어떻게 설치하나요?

Go 코드에서 Bubble Tea v2 패키지를 가져옵니다 bubbletea와 해당 종속성을 다운로드합니다: go mod tidy

bubbletea은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/charmbracelet/bubbletea