텐센트 위노라, 문서 던지면 위키까지 자동으로 만들어주는 RAG 플랫폼
PDF·워드·마크다운을 넣기만 하면 벡터 검색 가능한 RAG, 다단계 추론 에이전트, 문서 간 링크가 걸린 위키를 한 번에 생성합니다. 도커·도커 컴포즈·깃만 있으면 docker compose up -d 한 줄로 로컬에서 바로 돌릴 수 있고, 올라마 연동으로 완전 로컬 실행도 가능합니다. 단, 저장소 루트의 LICENSE 파일이 없어 사내·상용 배포 전 라이선스 확인이 필수입니다.
문서만 쌓아두면 검색도, 추론도, 위키 정리도 알아서 해주는 오픈소스 지식 플랫폼이 있습니다. 텐센트가 공개한 위노라(WeKnora) 이야기입니다.
위노라(WeKnora)는 무엇인가요
WeKnora는 Tencent에서 1년 2개월 전(2025년 7월) 공개한 오픈소스 LLM 지식 프레임워크예요. 원시 PDF, 워드, 마크다운 등 다양한 문서를 업로드하면 세 가지 모드—RAG 검색, 다단계 작업을 수행하는 에이전트, 그리고 자동으로 연결된 위키—에서 동시에 활용할 수 있습니다. 같은 지식 베이스를 공유하기 때문에 검색·추론·위키 관리가 일관되게 이루어집니다.
주요 기능으로는 크로스 세션 장기 메모리가 있어 사용자 프로필·선호·확인된 사실을 기억하고, 폴더 업로드 시 디렉터리 트리를 그대로 유지합니다. 검색에 사용되는 청크는 편집·차이점 확인·롤백이 가능하고, Feishu Wiki·Confluence·Notion·RSS 등 10여 개 소스와 10가지 이상의 파일 형식(PDF, Word, 이미지, Excel, XMind 등)을 자동 동기화합니다. 또한 WeCom·Slack·Telegram 등 여러 메신저와 임베드 위젯, Cursor·Claude용 MCP 서버까지 통합돼 팀 협업에 바로 적용할 수 있어요.
- Stars: 29,636개
- Forks: 3,990개
- 주 언어: Go
- 주요 태그: agent, rag, wiki, llm, multi-tenant, ollama, openai 등
지원 문서 형식
- Word
- 마크다운
- 이미지
- Excel
- XMind
왜 쓰나요 — 기존 RAG·위키 도구와 다른 점
문서만 넣어두면 RAG 검색, 멀티스텝 에이전트, 자동 위키 세 가지 모드가 한 번에 돌아가는 점이 가장 큰 차별점이에요. 폴더 트리를 그대로 유지하면서 청크 단위로 편집·비교·롤백이 가능하고, 세션이 끊겨도 사용자 프로필·선호·확인된 사실을 장기 메모리로 기억해 다음 대화에 이어 씁니다.
자료 연동도 넓습니다. 10여 가지 포맷(PDF·Word·이미지·Excel·XMind 등)을 in-process 파서(anydoc)로 처리하고, Feishu Wiki·Drive, Confluence, GitLab, Notion, Yuque, DingTalk Docs, RSS 등 외부 소스를 자동 동기화해 지식 베이스를 최신 상태로 유지해요.
지식 구조 시각화·버전 관리
문서 간 링크가 걸린 위키를 자동 생성하고, 그래프 뷰로 지식 구조를 한눈에 파악합니다. 청크 단위 수정 이력·롤백을 버튼 하나로 처리해 협업 중 실수를 되돌리기도 쉽습니다.
| 구분 | 기존 RAG·위키 도구 | WeKnora |
|---|---|---|
| 자동 위키 생성 | 수동 작성·별도 툴 필요 | 문서 투입 시 자동 생성 |
| 멀티테넌트 | 제한적 또는 없음 | 네이티브 지원 |
| 채널 | 웹·API 위주 | 위챗·슬랙·텔레그램·위젯·MCP |
| 외부 동기화 | 개별 커넥터 개발 필요 | 10+ 소스 기본 제공 |
| 버전 관리 | 파일 단위 위주 | 청크 단위 편집·롤백 |
요약하면 문서 투입 → 벡터화·그래프화 → 멀티채널 서비스 전 과정을 별도 파이프라인 없이 한 플랫폼에서 해결할 수 있다는 게 핵심 차이입니다.
설치·실행 단계 — 도커 한 줄로 끝내기
위노라(WeKnora)는 도커·도커 컴포즈·깃만 있으면 로컬에서 바로 띄울 수 있어요. 저장소를 내려받고 컴포즈 한 줄로 전체 스택을 올리는 순서를 정리해 드릴게요.
git clone https://github.com/Tencent/WeKnora.git
cd WeKnora
# ① 기본 실행
docker compose up -d
# ② 전체 기능(풀 프로파일)
docker compose --profile full up -d
# ③ 올라마 연동 시(호스트에서 선실행 필요)
ollama serve # 별도 터미널에서 실행 후 위 명령 재실행한눈에 보기 — 주요 스펙·지원 매트릭스
위노라는 Go로 작성됐으며 깃허브 기준 스타 29,636개 · 포크 3,990개를 기록 중이에요. 저장소는 1년 2개월 전(2025년 7월)에 처음 만들어졌고, 이번 달(2026년 9월)에도 업데이트가 이어지고 있어요. 라이선스 표기는 README에 별도로 없어 사내·상용 배포 전에는 저장소 루트의 LICENSE 파일을 꼭 확인하세요.
| 항목 | 세부 내용 |
|---|---|
| 주 언어 | Go |
| 스타 / 포크 | 29,636 ⭐ / 3,990 🍴 |
| 최초 공개 | 1년 2개월 전(2025년 7월) |
| 최근 업데이트 | 이번 달(2026년 9월) |
| 지원 문서 포맷 | PDF, Word, 이미지, Excel, XMind 등 10종 이상 (Office 파일은 anydoc으로 인-프로세스 파싱) |
| 자동 동기화 소스 | 페이슈 위키/드라이브, 컨플루언스, 깃랩, 텐센트 IMA, 노션, 유큐, 딩톡 독스, RSS 등 |
| 연동 채널 | 위컴, 페이슈, 슬랙, 텔레그램 등 IM 앱 Q&A · 외부 사이트 임베드 위젯 · MCP 서버(커서, 클로드 등) |
| 프로파일 옵션 | 기본 경량 · --profile full 로 전체 스택(풀 프로파일) 활성화 |
| 로컬 LLM 연동 | 올라마(ollama serve) 선행 후 도커 컴포즈 실행 |
git clone https://github.com/Tencent/WeKnora.git
cd WeKnora
docker compose up -d # 기본 경량 실행
docker compose --profile full up -d # 전체 기능(풀 프로파일) 실행주의할 점 — 라이선스 미표기 리스크
깃허브 저장소 Tencent/WeKnora를 보면 LICENSE 파일이 없고, README에도 라이선스 표기가 없습니다. 스타 29,636개·포크 3,990개로 인기 있지만, 오픈소스 라이선스 부재는 재배포·수정·상용 이용 시 법적 리스크가 됩니다.
저장소 루트 확인
git clone https://github.com/Tencent/WeKnora.git후ls -la로 LICENSE 파일 존재 여부 확인공식 사이트·이슈 검색
공식 문서(weknora.weixin.qq.com)나 Issues 탭에서 라이선스 논의가 있는지 찾아보기
법무팀에 공유
확인된 사실(라이선스 없음)을 근거로 사내 사용 가능 범위·기여자 라이선스 동의(CLA) 필요 여부 검토 요청
git clone https://github.com/Tencent/WeKnora.git
cd WeKnora
ls -la | grep -i license자주 묻는 질문
Q. 라이선스 파일이 없으면 무조건 못 쓰나요? A. 법적으로 '모든 권리 보유'로 간주될 수 있어, 사내 테스트조차 위험할 수 있습니다. 반드시 법무 확인 후 진행하세요.
Q. 텐센트 저장소인데 왜 라이선스가 없나요? A. 공개 시점에 라이선스 추가를 누락했거나, 내부 정책상 별도 계약으로만 허용할 수 있습니다. 이슈·PR로 문의해도 좋습니다.
- README·저장소 루트 모두 라이선스 표기 없음
- 상용·사내 배포 전 법무 검토 필수
- 이슈·공식 문서에서 라이선스 논의 여부 지속 모니터링
정리 — 지금 바로 해볼 수 있는 다음 액션
위노라(WeKnora)를 5분 만에 로컬에서 끝까지 돌려보기 위한 최소 실천 루틴을 정리했어요. 도커·도커 컴포즈·깃만 있으면 되고, GPU가 없어도 CPU 모드로 먼저 확인할 수 있어요.
위 순서대로만 따라 하면 클론 → 기동 → 업로드 → RAG·에이전트·위키 3모드 검증까지 5분 안에 마무리할 수 있어요. 먼저 로컬에서 돌려보고, 팀 위키·노션·컨플루언스 연동이나 임베딩 모델 교체 같은 다음 단계를 고민해보세요.