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 라이선스로 공개되어 있어 개인 및 상업적 목적으로 자유롭게 사용, 수정, 배포할 수 있습니다.
WUPHF 프로젝트 GitHub 저장소
WUPHF 공식 홈페이지
더 읽어보기
-
Claude Flow: 여러 개발 AI 에이전트들의 협력을 제어하고 자동화하는 AI 오케스트레이션 플랫폼(AI Orchestration Platform)
-
Agent Squad: AWS가 오픈소스로 공개한, Multi-Agents 간 복잡한 대화 관리를 위한 경량 프레임워크
-
Async Code Agent: Codex UI 스타일로 Claude Code까지 사용할 수 있는 코드 에이전트 프로젝트
이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다. ![]()
파이토치 한국 사용자 모임
이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일
로 보내드립니다! (기본은 Weekly지만 Daily로 변경도 가능합니다.)
아래
쪽에 좋아요
를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~ ![]()

