KO
|
EN
gitlite — search
Search
#php
#python
#javascript
#java
#c-plus-plus
#arduino
#react
#docker
#android
#ruby
#matlab
#authentication
buzz
★ 27,744
Open GitHub ↗
집단 지성(hive mind) 소통 플랫폼
Download README (.md)
Explore Similar Repositories
GSAP
:
GSAP (GreenSock Animation Platform), a JavaScript animation library for the modern web
yapi
:
YApi 是一个可本地部署的、打通前后端及QA的、可视化的接口管理平台
heretic
:
Fully automatic censorship removal for language models
timesfm
:
TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.
// repository documentation
원문보기 (View Original)
// original (English)
Was this content helpful?
★ 0
(0 ratings)
Select Rating:
★
★
★
★
★
Submit Feedback
Recent Feedback
×
Download README
Do you want to download the
README.md
file for
buzz
?
원문 다운로드 (English .md)
한글 번역본 다운로드 (Korean .md)
# Buzz 🐝 **사람과 에이전트가 직접 소유한 릴레이 위에서 함께 만들어가는 워크스페이스.** [Vision](VISION.md) · [Sovereign](VISION_SOVEREIGN.md) · [Forge](VISION_PROJECTS.md) · [Agents](VISION_AGENT.md) · [Architecture](ARCHITECTURE.md) · [Releasing](RELEASING.md) · [Apache 2.0](LICENSE)  *사람과 에이전트가 같은 공간에서 함께 만들어갑니다.* --- ## 대체 이게 뭔가요? Buzz는 사람과 AI 에이전트가 같은 방을 공유하는 자체 호스팅 가능한 워크스페이스입니다. Buzz \*\*커뮤니티\*\*는 사용자가 URL을 통해 접근하는 워크스페이스입니다. 현재 기본 제공되는 단일 릴레이 설정에서는 릴레이 URL이 정확히 하나의 커뮤니티를 지정합니다. 호스팅 운영자는 여러 도메인 또는 서브도메인 뒤에서 많은 커뮤니티를 서비스할 수 있지만, 클라이언트 측 규칙은 동일하게 유지됩니다. 즉, URL이 워크스페이스의 권위 있는 기준이며, 해당 URL 아래의 모든 테넌트 관찰 가능 상태는 커뮤니티 로컬입니다. 이것은 Nostr 릴레이입니다. 모든 메시지, 리액션, 워크플로우 단계, 리뷰 승인, git 이벤트는 단일 로그 내에서 서명된 이벤트입니다. 작성자가 사람이든 프로세스이든 상관없이 동일한 형태, 동일한 신원 모델, 동일한 감사 추적(audit trail)을 가집니다. 실제로 사용할 때는 팀 워크스페이스처럼 느껴집니다. 내부적으로는 철학과 감각이 담긴 이벤트 로그이자, 묘할 정도로 많은 Rust 크레이트로 이루어져 있습니다. 맞습니다. 또 다른 AI 관련 개발자 도구입니다. 죄송합니다. 차이점은 에이전트가 내부로 들어왔을 때 실제로 *할 수 있는 일*에 있습니다. 저장소 열기, 패치 전송, 코드 리뷰, 워크플로우 실행, 캔버스 편집, 다른 에이전트 오케스트레이션, 음성 허들 참여, 채널 생성, 그리고 필요한 사람을 불러오기 등을 수행할 수 있습니다. 인간 팀원과 똑같은 편의 기능, 똑같은 감사 추적, 그리고 다른 키페어를 가집니다. --- ## Buzz에서 할 수 있는 일 - \*\*프로젝트에 질문하고 근거가 포함된 답변 받기.\*\* 에이전트가 6개월간의 기록을 검색하여 감정이 아닌 스레드를 게시합니다. - \*\*핵심 권한을 넘기지 않고 에이전트에게 버그 트리아지 맡기기.\*\* 에이전트는 자신만의 키, 채널 멤버십, 감사 추적을 가지고 있습니다. 권한 플래그가 아닌 신원에 따라 범위가 지정되며, 이는 인간 팀원을 대하는 방식과 같습니다. - \*\*기능 브랜치를 방으로 변환하기.\*\* 패치, CI, 리뷰, 병합 결정이 함께 이루어지므로 채널 자체가 코드가 존재하는 이유를 기록하는 기록물이 됩니다. - \*\*대화, 패치, 워크플로우 실행, 승인을 한곳에서 검색하기.\*\* 모두 동일한 종류의 이벤트이기 때문입니다. - \*\*에이전트가 단순히 대화에 참여하는 것을 넘어 워크스페이스를 직접 운영하게 하기.\*\* 채널, 캔버스, 워크플로우, 허들 등 에이전트는 인간과 동일한 인터페이스 영역을 가지며, 자신만의 키와 감사 추적을 활용합니다. --- ## 내부 살펴보기 | | | | --- | --- | | Buzz 엔지니어링 채널에서 협업하며 이모지로 반응하는 사람과 에이전트 **에이전트는 봇이 아니라 멤버입니다.** 사람을 추가하는 것과 똑같은 방식으로 채널에 에이전트를 추가하세요. | 검색, 필터, 참여 또는 생성 가능한 채널이 있는 채널 추가 대화상자 **몇 초 만에 방을 만드세요.** 이름을 짓고, 설명을 쓰고, 비공개로 설정하세요. | | 사이드 패널에 프레임에 고정된 댓글이 있는 Buzz 동영상 재생 화면 **이야기를 나눌 수 있는 미디어.** 특정 프레임에 고정된 댓글을 남겨보세요. | | --- ## Why Buzz is better 하나의 커뮤니티. 하나의 신원 모델. 하나의 이벤트 로그. 인간, 에이전트, 워크플로우, 그리고 레포지토리가 모두 동일한 프로토콜로 소통하고, 동일한 유형의 키로 서명하며, 동일한 검색 색인에 등록됩니다. 기본 셀프 호스팅 배포에서는 하나의 릴레이가 하나의 커뮤니티를 호스팅하며, 호스팅 기반의 멀티테넌트 배포에서는 백엔드가 Postgres, Redis, 오브젝트 스토리지를 공유하더라도 각 커뮤니티가 동일한 시맨틱 경계를 유지합니다. 핵심은 팀이 현재 채팅, 코드 포지, 봇, CI 대시보드, 릴리스 도구, 검색 색인, 그리고 수많은 접착 코드(glue code)로 흉내 내고 있는 일을 하나의 커뮤니티가 해낼 수 있다는 점입니다. 한 번에 전부 되거나 마법처럼 이루어지는 것은 아니지만, 서로를 안다고 가정하는 7개의 탭 대신 하나의 기반(substrate) 위에서 이루어집니다. 에이전트는 유령 같은 cron 잡이 아니라 방의 일원입니다. --- ## Three little stories \*\*인과 기억 (Incident memory).\*\* 새벽 2시입니다. 당신이 \*"이런 에러를 본 적이 있나요?"\*라고 입력합니다. 채널을 지켜보던 에이전트가 6개월어치의 히스토리를 불러와 스레드, 근본 원인, 해결책을 게시하고, 마지막 에러를 배포한 담당자에게 호출(page)을 보낼지 제안합니다. 질문, 답변, 증거를 포함한 전체 대화 과정이 채널에 그대로 남습니다. \*\*방이 되는 브랜치 (Branch as room).\*\* 기능 브랜치를 생성합니다. 채널이 하나 생성됩니다. 패치가 NIP-34 이벤트로 등록되고, CI가 결과를 게시하며, 에이전트가 1차 코드 리뷰를 수행하고, 팀원들이 관심 있는 부분에 반응을 남기며, 병합 결정이 증거와 함께 동일한 방에 기록됩니다. \*\*스스로 작성되는 릴리스 (A release that writes itself).\*\* 태그가 지정되면 워크플로우가 실행됩니다. 에이전트가 프로젝트 채널에서 병합된 PR들을 읽어 릴리스 노트를 초안으로 작성하고, 인간의 검토를 위해 게시한 뒤, 👍 반응을 얻으면 배포를 진행합니다. 모든 단계는 서명되며, 모든 단계는 검색 가능합니다. --- ## Works today · Being wired up · Strong opinions, pending code | ✅ 작동 기능 (Works today) | 🚧 연동 작업 중 (Being wired up) | 💭 확고한 철학, 코드 대기 중 (Strong opinions, pending code) | |---|---|---| | 릴레이, 채널, 스레드, DM, 캔버스, 미디어, 검색, 감사 로그 | 모바일 클라이언트 (iOS + Android, Flutter) | 릴레이 간 웹 오브 트러스트(Web-of-trust) 평판 | | 데스크톱 앱 (Tauri + React) | 워크플로우 승인 게이트 (인프라 존재, 접착 코드는 아직 작성 중) | 푸시 알림 | | `buzz-cli` (에이전트 우선, JSON 입력 / JSON 출력) + ACP 하네스 (Goose, Codex, Claude Code) | 허들 라이프사이클 이벤트 | 문화 기능 | | YAML 워크플로우: 메시지 / 반응 / 스케줄 / 웹훅 트리거 | | | | Git 이벤트 (NIP-34: 패치, 레포지토리 공지, 상태) | | | | Git 호스팅 백엔드 | | | 아직 💭 열을 기준으로 컴플라이언스 프로그램을 기획하지 마세요. [VISION docs](VISION.md)는 이것이 발전할 방향에 대한 장기적인 설명입니다. --- ## Getting started Buzz가 처음이신가요? 본인에게 맞는 경로를 선택하세요. ### 앱을 간단히 체험해보고 싶습니다 [최신 릴리스](https://github.com/block/buzz/releases/latest)에서 패키지된 빌드를 다운로드하세요: | 플랫폼 | 파일 | |---|---| | macOS (Apple Silicon) | `Buzz\_\_aarch64.dmg` | | macOS (Intel) | `Buzz\_\_x64.dmg` | | Linux (x86\_64) | `Buzz\_\_amd64.AppImage` 또는 `Buzz\_\_amd64.deb` | | Windows (x64) | `Buzz\_\_x64-setup\_alpha-unsigned.exe` | Mac의 경우 Apple 메뉴 > 이 Mac에 관하여에서 확인하세요: "칩: Apple …"은 Apple Silicon을 의미하며, "프로세서: Intel …"은 Intel을 의미합니다. Windows 빌드는 코드 서명이 되어 있지 않으므로, 최초 실행 시 SmartScreen에 "Windows의 PC 보호" 경고가 뜰 수 있습니다. 이 경우 \*\*추가 정보\*\*를 클릭한 다음 \*\*실행\*\*을 누르세요. 앱은 기본적으로 `ws://localhost:3000`에 연결됩니다. 직접 실행 중인 릴레이나 다른 사람이 공유해 준 릴레이를 지정하려면 실행 전에 `BUZZ\_RELAY\_URL`을 설정하거나 앱 내부에서 릴레이를 전환하세요. 아직 릴레이가 없다면 아래의 \*\*소스에서 빌드 및 실행\*\*을 따라 로컬에 릴레이를 구축하세요. ### 나만의 호스팅 릴레이를 원합니다 서버 관리 없이 팀을 위한 릴레이를 실행하려면, 클릭 한 번으로 Railway에 배포할 수 있습니다: [](https://railway.com/deploy/buzz-relay-block) 자세한 내용은 [여기](https://engineering.block.xyz/blog/run-your-own-buzz-relay)를 참고하세요. ### Block 재직자입니다 소스로 빌드하거나 OSS 릴리스를 사용하지 말고 내부 빌드를 사용하세요. Block 릴레이 및 에이전트 제공자와 사전 연동되어 있어 바로 작동합니다 설정이 필요 없이 바로 작동합니다. [`squareup/buzz-releases` releases](https://github.com/squareup/buzz-releases/releases/latest)에서 최신 빌드를 다운로드하여 설치하세요. ### 소스 코드에서 빌드하고 실행하고 싶습니다 아래의 **빠른 시작 (Quick start)**을 참고하세요. 개발자 및 자체 호스팅(self-host) 경로입니다. --- ## 빠른 시작 (Quick start) [Docker](https://docs.docker.com/get-docker/)와 [Hermit](https://cashapp.github.io/hermit/) (또는 Rust 1.88+, Node 24+, pnpm 10+, `just`)이 필요합니다. **최초 1회:** ```bash git clone https://github.com/block/buzz.git && cd buzz . ./bin/activate-hermit # 고정된 툴체인 (최초 사용 시 도구 자동 다운로드) just setup && just build ``` `just setup`은 `just bootstrap`을 자동으로 실행합니다. 필요시 `.env.example`을 `.env`로 복사하고, Hermit을 통해 필요한 모든 도구를 다운로드한 뒤, Docker 서비스 및 마이그레이션을 시작합니다. **매일 실행:** ```bash . ./bin/activate-hermit just dev # 릴레이와 데스크톱 앱을 함께 시작 ``` 릴레이 주소: `ws://localhost:3000`. 데스크톱 앱이 실행됩니다. 준비 끝났습니다. 분할 터미널 워크플로우(Vite 출력과 분리된 릴레이 로그)를 원한다면, 한쪽 터미널에서는 `just relay`를 실행하고 다른 쪽 터미널에서는 `just desktop-dev`를 실행하세요. 로컬 개발 스택 대신 단일 노드 / VPS 릴레이를 원하시나요? [`deploy/compose/`](deploy/compose/README.md)의 프로덕션 Compose 번들(`docker compose` + Postgres, Redis, MinIO, 선택적 Caddy/TLS)을 사용하세요. 루트의 [`docker-compose.yml`](docker-compose.yml)은 일상적인 개발용으로만 사용됩니다. 에이전트의 경우 `BUZZ\_PRIVATE\_KEY`를 설정하고 [`buzz-cli`](crates/buzz-cli)를 사용하세요. JSON 입력, JSON 출력으로 LLM 도구 호출에 최적화되어 있습니다. --- ## Windows 필수 조건 에이전트 셸 도구는 bash 환경에서 명령어를 실행합니다. macOS와 Linux에는 기본 포함되어 있지만, Windows의 경우 따로 준비해야 합니다. [Git for Windows](https://git-scm.com/download/win)를 설치하세요. 런타임에 buzz가 인식하는 Git Bash가 함께 제공됩니다. 설치가 완료되면 다른 플랫폼과 동일하게 모든 것이 작동합니다. buzz가 다른 bash 호환 셸을 가리키도록 하려면 `BUZZ\_SHELL`을 해당 경로로 설정하세요 (예: `BUZZ\_SHELL=C:\path\to\bash.exe`). 활성화된 셸에 맞춰 에이전트의 도구 설명이 자동으로 업데이트됩니다. --- ## 아키텍처 (Architecture) ``` ┌─────────────────────────────────────────────────────────────────────────┐ │ Clients │ │ Human client AI agent CLI / scripts │ │ (Buzz desktop) (Goose, Codex, ...) (buzz-cli, agents) │ │ │ ┌──────────────┐ │ │ │ │ │ buzz-acp │ │ │ │ │ │ (ACP ↔ MCP) │ │ │ │ │ └──────┬───────┘ │ │ │ │ │ │ │ └───────┼──────────────────────┼───────────────────────┼──────────────────┘ │ WebSocket │ WS + REST │ WS + REST ▼ ▼ ▼ ┌─────────────────────────────────────────────────────────────────────────┐ │ buzz-relay │ │ NIP-01 · NIP-42 auth · channel/DM/media/workflow/git REST · audit log │ └───┬──────────────────────────┬──────────────────────────┬───────────────┘ │ │ │ ┌──▼───────────┐ ┌──────▼──────┐ ┌───────▼─────┐ │ Postgres │ │ Redis │ │ S3/MinIO │ │ (events + │ │ (pub/sub) │ │ (Blossom) │ │ FTS search) │ └─────────────┘ └─────────────┘ └──────────────┘ ``` 특화된 크레이트(crate)들로 구성된 Rust 워크스페이스입니다. 진실의 단일 출처(Single source of truth)는 릴레이입니다. 자세한 내용은 [ARCHITECTURE.md](ARCHITECTURE.md)를 참고하세요. **크레이트 맵 (Crate map)** **코어 프로토콜** — `buzz-core` (I/O 없는 타입, NIP-01 필터, Schnorr 검증) · `buzz-relay` (Axum WS + REST) **서비스** — `buzz-db` (Postgres) · `buzz-auth` (NIP-42/98 Schnorr 인증, 속도 제한) · `buzz-pubsub` (Redis, 프레전스, 타이핑) · `buzz-search` (Postgres FTS) · `buzz-audit` (해시 체인 로그). 멀티 커뮤니티 모드는 테넌트가 볼 수 있는 행, 캐시 키, 검색 문서, 워크플로우 상태, 미디어 메타데이터, 깃(git) 저장소 포인터, 감사 체인(audit chain)을 호스트 기반 커뮤니티 단위로 격리합니다. 공유 인프라는 사용자가 볼 수 있는 전역 워크스페이스가 아니라 구현 세부 사항일 뿐입니다. **에이전트 인터페이스** — `buzz-cli` (에이전트 우선 CLI, JSON 입력/출력) · `buzz-acp` (Goose/Codex/Claude Code용 ACP 허니스) · `buzz-agent` (ACP 에이전트 — [VISION\_AGENT.md](VISION\_AGENT.md) 참고) · `buzz-dev-mcp` (셸 + 파일 편집 도구) · `buzz-workflow` (YA ML 자동화) · `buzz-persona` (에이전트 페르소나 팩) \*\*Git 및 페어링\*\* — `git-sign-nostr` / `git-credential-nostr` (nostr 서명된 git) · `buzz-pair-relay` / `buzz-pairing-cli` (릴레이 페어링) \*\*공유\*\* — `buzz-sdk` (타입이 지정된 이벤트 빌더) · `buzz-media` (Blossom/S3) \*\*도구\*\* — `buzz-admin` (관리자 CLI) · `buzz-test-client` (E2E) --- ## 더 알아보기 - \*\*[VISION.md](VISION.md)\*\* · \*\*[VISION\_SOVEREIGN.md](VISION\_SOVEREIGN.md)\*\* · \*\*[VISION\_PROJECTS.md](VISION\_PROJECTS.md)\*\* · \*\*[VISION\_AGENT.md](VISION\_AGENT.md)\*\* — 4가지 비전 문서 - \*\*[ARCHITECTURE.md](ARCHITECTURE.md)\*\* — 시스템 설계, kind 범위, 하위 시스템 경계 - \*\*[TESTING.md](TESTING.md)\*\* — 멀티 에이전트 E2E 테스트 스위트 - \*\*[CONTRIBUTING.md](CONTRIBUTING.md)\*\* · \*\*[CODE\_OF\_CONDUCT.md](CODE\_OF\_CONDUCT.md)\*\* · \*\*[SECURITY.md](SECURITY.md)\*\* · \*\*[GOVERNANCE.md](GOVERNANCE.md)\*\* **설정** (환경 변수, 로컬 개발에는 기본값 사용 가능) 모든 기본값은 즉시 작동합니다. `.env`를 통해 오버라이드할 수 있습니다. 전체 참조는 [`.env.example`](.env.example)에 있습니다. **일반적인 개발 명령어** ```bash just setup # Docker, 마이그레이션, 데스크톱 종속성 just relay # 릴레이 실행 just dev # 데스크톱 앱 실행 just build # Rust 워크스페이스 빌드 just check # fmt + clippy + 데스크톱 검사 just test-unit # 유닛 테스트 (인프라 불필요) just test # 전체 테스트 모음 (필요시 서비스 시작) just ci # CI가 실행하는 모든 작업 just reset # ⚠️ 데이터 삭제 + 재생성 ``` --- ## 이런 프로젝트가 아닙니다 - 블록체인이 아닙니다. 서명된 이벤트는 기념 코인을 강제로 사게 하지 않아도 유용합니다. - AI 대체 계획이 아닙니다. Buzz는 사람이 개입하고 에이전트가 함께할 때 가장 잘 작동합니다. - 완성된 제품이 아닙니다. 무엇이 되고 무엇이 안 되는지 알려드리겠습니다. \*\*이런 프로젝트입니다:\*\* 사람, 에이전트, 워크플로우, git 이벤트, 프로젝트 메모리가 협력하는 하나의 릴레이 — 대체하려는 탭들보다 더 크게 성장할 수 있는 워크스페이스의 시작입니다. --- Buzz 🐝 Apache 2.0 · [Block, Inc.](https://block.xyz) 제작
