WUPHF: 공유 브레인을 가진 AI 직원들의 협업 오피스 플랫폼 (a.k.a. AI 직원들을 위한 Slack)

WUPHF 소개

단일 AI 에이전트가 혼자 작업하는 방식은 복잡한 비즈니스 워크플로우를 처리하기에 본질적인 한계를 지닙니다. 에이전트 하나가 모든 도메인 전문 지식을 갖출 수 없고, 장기적인 컨텍스트를 완전히 유지하기 어려우며, 병렬 작업 처리에도 제약이 있습니다. 여러 AI 에이전트가 협업하는 멀티에이전트 시스템은 이 문제를 해결하는 방향이지만, 기존 접근법들은 에이전트들이 독립적인 컨텍스트로 작동하며 서로의 작업을 모르거나, 개발자가 코드로 에이전트 간 통신을 직접 정의해야 하는 어려움이 있었습니다.

WUPHF는 이 문제를 "AI 직원들의 공유 오피스"라는 비유로 해결합니다. CEO, PM, 엔지니어, 디자이너, CMO, CRO 역할의 AI 에이전트들이 Slack과 유사한 채널 기반 인터페이스에서 함께 볼 수 있고, 논쟁하고, 업무를 선점하며, 자율적으로 작업을 완수하는 환경을 제공합니다. npx wuphf 단 하나의 명령으로 시작되며, 브라우저가 자동으로 열리면서 팀 전체가 활동하는 오피스 화면을 볼 수 있습니다.

WUPHF는 Go 언어로 구현된 백엔드와 웹 기반 UI를 가진 오픈소스 플랫폼입니다. MIT 라이선스로 공개되어 있으며, 기본적으로 Claude Code를 LLM 제공자로 사용하고 --provider codex 옵션으로 OpenAI Codex CLI로 전환할 수 있습니다. 현재 pre-1.0 단계로 활발하게 개발 중이며, main 브랜치가 매일 업데이트됩니다.

WUPHF의 지식 관리: 노트북과 위키

WUPHF의 핵심 차별점 중 하나는 AI 직원들이 개인 노트북과 팀 공유 위키를 통해 지식을 축적하고 공유하는 구조입니다. 에이전트가 API 목록을 그냥 잊어버리거나, 이전 세션에서 결정한 아키텍처를 다음 세션에서 모르는 문제가 발생하지 않도록 설계되었습니다.

모든 에이전트는 자신만의 노트북(Notebook) 을 갖습니다. 에이전트는 태스크를 수행하면서 원시 컨텍스트, 관찰, 잠정적 결론을 노트북에 기록합니다. 이는 에이전트 개인의 작업 공간으로, 범위가 지정되어 있고 로컬에 보관됩니다.

팀 전체는 위키(Wiki) 를 공유합니다. 노트북의 내용 중 지속적인 가치가 있는 것이 판단되면, 에이전트는 위키로 승격(Promote)시킵니다. 위키는 워크스페이스 전체가 공유하며, 다른 에이전트들이 조회할 수 있습니다. 승격은 자동으로 일어나지 않으며, 에이전트가 판단하여 결정합니다.

기본 위키 백엔드(team-wiki/markdown)는 단순한 마크다운 폴더가 아닙니다. ~/.wuphf/wiki/ 경로에 로컬 git 저장소로 저장되는 살아있는 지식 그래프입니다. 타입화된 사실(Fact)과 트리플렛(Triplet), 엔티티별 추가 전용 사실 로그, LLM이 합성한 브리핑, /lookup 인용 답변 검색, 모순/고아/오래된 클레임/끊어진 교차 참조를 감지하는 /lint 기능을 포함합니다. cat, grep, git log, git clone 등 일반 도구로 모두 접근 가능합니다.

WUPHF 설치 및 시작하기

# 가장 빠른 시작 (Node.js 20+ 필요)
npx wuphf

# 전역 설치 후 실행
npm install -g wuphf && wuphf

# 소스에서 빌드 (Go 필요)
git clone https://github.com/nex-crm/wuphf.git
cd wuphf
go build -o wuphf ./cmd/wuphf
./wuphf

실행하면 http://localhost:7891에 브라우저 탭이 자동으로 열리고, #general 공유 채널과 활동 중인 팀 에이전트들, 메시지 작성 컴포저(Composer)가 표시됩니다.

주요 옵션

# 에이전트 팩 선택 (starter, founding-team, coding-team, lead-gen-agency, revops)
wuphf --pack coding-team

# CEO를 Claude Opus로 업그레이드
wuphf --opus-ceo

# LLM 제공자 변경 (claude-code 또는 codex)
wuphf --provider codex

# 특정 에이전트와 1:1 대화
wuphf --1o1 cro

# 세션 종료
wuphf shred

AI 어시스턴트를 통한 설치

Claude Code, Codex, Cursor에 다음 프롬프트를 입력하면 에이전트가 설치를 진행합니다:

Set up https://github.com/nex-crm/wuphf for me.
Read README.md first, then run npx wuphf to install and launch the office.

WUPHF의 메모리 백엔드 옵션

백엔드 특징 API 키 필요 여부
markdown (기본) 로컬 git 저장소 기반 지식 그래프. 타입화된 사실, 트리플렛, /lint 기능 불필요
nex Nex/WUPHF 관리형 컨텍스트 그래프 + 통합 기능 WUPHF/Nex API 키 필요
gbrain gbrain serve 마운트. OpenAI 키로 임베딩+벡터 검색, Anthropic 키로는 감소 모드 OpenAI 또는 Anthropic 키
none 공유 위키 비활성화. 개인 노트북만 사용 불필요
# 백엔드 선택 예시
wuphf --memory-backend markdown  # 신규 설치 기본값
wuphf --memory-backend nex
wuphf --memory-backend gbrain
wuphf --memory-backend none

라이선스

WUPHF는 MIT 라이선스로 공개되어 있어 개인 및 상업적 목적으로 자유롭게 사용, 수정, 배포할 수 있습니다.

:github: WUPHF 프로젝트 GitHub 저장소

:house: WUPHF 공식 홈페이지

더 읽어보기




이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다. :hugs:

:pytorch:파이토치 한국 사용자 모임:south_korea:이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일:love_letter:로 보내드립니다! (기본은 Weekly지만 Daily로 변경도 가능합니다.)

:wrapped_gift: 아래:down_right_arrow:쪽에 좋아요:+1:를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~ :star_struck: