Unbody
Unbody (Unbody Labs) · 코딩 · 기타
Unbody는 콘텐츠를 수집하고 가공하고 벡터화한 뒤, 하나의 GraphQL API로 시맨틱 검색과 챗봇, 생성형 답변을 제공하는 AI 네이티브 백엔드다.

Unbody 소개
About
Unbody란 무엇인가
Unbody는 AI 기능을 직접 조립하지 않으려는 개발팀을 위한 백엔드다. 데이터 소스를 연결하고 몇 가지 가공 단계를 고른 다음, 하나의 GraphQL 엔드포인트에서 결과를 조회한다. RAG 백엔드와 챗봇 백엔드를 한 상자에 담은 셈이었고, 벡터 데이터베이스와 임베딩 서비스, LLM 래퍼, 작업 큐를 따로 맞춰야 할 필요가 없었다.
구조는 네 계층으로 나뉜다. 인지 계층은 수집과 파싱, 가공, 벡터화를 맡는다. 기억 계층은 만들어진 객체와 벡터를 저장한다. 추론 계층은 모델 호출과 프롬프트를 실행한다. 행동 계층은 API와 SDK로 외부에 내보낸다. 기본 커넥터는 Google Drive, Discord, GitHub를 지원하고, 나머지는 Push API에 직접 정의한 스키마를 넘기면 받아들인다. 가공 도구는 색인 전에 요약과 키워드, 이미지 캡션, OCR 텍스트, 크롤링한 페이지를 덧붙인다.
기능보다 무거운 사실이 하나 있다. Unbody는 더 이상 개발되지 않는다. GitHub 저장소는 아카이브되었고, app.unbody.io의 호스팅 앱은 열리지 않으며, 문서 도메인은 오류만 돌려준다. 팀은 Unbody Labs라는 이름으로 별도의 메모리 프레임워크인 Adapt를 만들고 있다. 이 문서는 플랫폼이 제공하던 기능의 기록이며, 직접 실행하려는 사람에게는 보관된 코드 안내서이기도 하다. 코드는 알파 단계에 머물러 있고 아무도 수정본을 내놓지 않는다.
시작하기
- Node.js 20이나 22, Docker, Docker Compose, yarn을 준비한다. unbody-io/unbody 저장소를 복제하고 yarn으로 의존성을 설치한다.
- .env.example을 .env.local로 복사하고 OpenAI API 키를 넣는다. 임베딩과 생성 엔드포인트가 이 키로 동작한다.
- docker compose up으로 주변 서비스를 띄운 뒤 yarn start를 실행한다. 색인 작업은 Temporal을 거치고, 대시보드는 8233번 포트에 열린다.
- 프로젝트를 만들고 unbody-cli source add 명령으로 데이터 소스를 추가한다. 첫 파일이 파싱과 가공, 벡터화를 지나는 과정을 볼 수 있다.
- GraphQL API나 TypeScript SDK로 프로젝트를 조회한다. SDK는 검색과 조회, 생성 호출을 연결형 클라이언트로 묶는다.
제품 정보
Unbody의 요금, 지원 플랫폼, 성능을 한눈에 확인해 보세요.
추천 대상
이 도구가 가장 잘 맞는 사용자, 작업, 상황입니다.
사용자
- 기존 제품에 검색이나 대화를 붙이는 백엔드 개발자
- 머신러닝 엔지니어가 없는 작은 제품팀
- 콘텐츠가 이미 Google Drive, Discord, GitHub에 있는 팀
작업
- 문서 더미를 검색 가능한 지식 베이스로 바꾸기
- 사이트에 문서 챗봇 붙이기
- 요약과 태그를 한꺼번에 처리하기
- 의미나 시각적 유사도 시험하기
활용 상황
- 직접 만들기 전에 AI 네이티브 백엔드를 평가할 때
- 오래된 프로젝트를 계속 돌릴 때
- RAG 흐름을 가르치거나 시연할 때
주요 기능
하나의 GraphQL 콘텐츠 API
플랫폼이 저장한 모든 것은 하나의 GraphQL 엔드포인트에서 조회한다. 지식 베이스 API이자 시맨틱 검색 API 역할을 하며, 필터와 정렬, 페이지 나누기, 중첩 객체를 같은 질의에서 처리한다. 필요한 필드를 지정하면 생성된 요약과 키워드가 붙은 가공 레코드가 돌아온다. 이미지와 영상은 별도 엔드포인트가 처리하고, 관리 API는 대시보드 없이 프로젝트와 소스를 다룬다.
기본 커넥터와 Push API
Google Drive, Discord, GitHub에는 통합이 준비되어 있다. 각 통합은 폴더나 채널 같은 진입점을 정하고 정해진 주기로 내용을 가져온다. 나머지는 Push API가 맡는다. 직접 정의한 스키마로 레코드를 받아 사내 데이터베이스와 내보낸 아카이브, 자체 피드를 처리한다. 이 조합 덕분에 지식 제품을 시작할 때 맞춤 ETL을 쓰지 않아도 됐다.
가공 파이프라인
색인 전에 설정 가능한 파이프라인이 내용을 파싱하고 가공 도구를 차례로 적용한다. AutoSummary는 짧은 요약을 쓰고, AutoKeywords는 중요한 용어를 뽑고, AutoVision은 이미지 캡션과 OCR 문자 추출, 객체 태깅을 맡는다. 크롤러는 웹 페이지를 구조화된 레코드로 바꾼다. 파이프라인은 대시보드나 관리 API에서 구성하고, 기본 도구로 부족하면 자체 플러그인을 등록한다.
다섯 가지 검색 모드
API는 시맨틱 검색과 키워드 검색, 하이브리드 검색에 더해 레코드 유사도와 시각 유사도 두 가지를 제공한다. 시맨틱 검색은 의미로 대조하므로 사용자의 표현이 문서와 다를 때 효과가 있다. 키워드 검색은 정확한 용어에서 예측 가능하게 움직인다. 하이브리드는 둘을 섞는다. 시각 유사도는 이미지 벡터로 동작해서 제품 사진으로 카탈로그 안의 비슷한 상품을 찾는다.
생성 검색과 JSON 출력
조회 위에 두 가지 생성 모드가 올라간다. From One은 객체마다 프롬프트를 보내고 필드 값을 문장에 끼워 넣는다. From Many는 여러 객체에서 하나의 결과를 만들어 요약과 비교에 알맞다. 별도 모드는 스키마로 검증한 구조화 JSON을 돌려주며, 산문이 아니라 필드 추출을 겨냥한다. 모델은 플러그인으로 고르므로 백엔드가 한 공급자에 묶이지 않는다.
TypeScript SDK와 화면 구성 요소
TypeScript SDK는 GraphQL 호출을 연결형 클라이언트로 바꾼다. 컬렉션을 가져오고, 걸러내고, 검색하고, 필드를 고른 뒤 생성한다. Next.js, Nuxt, NestJS, Express용 시작 프로젝트가 있고, 화면 계층에는 React와 Vue용 구성 요소가 있다. 어느 것도 호스팅 서비스에 묶이지 않는다. 같은 SDK가 로컬 인스턴스를 가리키면 된다.
장단점
장점
- 하나의 API가 수집과 가공, 벡터화, 검색, 생성을 처리해서 따로 떨어진 서비스 더미를 줄인다.
- 코드가 Apache 2.0으로 공개되어 구현을 읽고 포크해서 자신의 하드웨어에서 돌릴 수 있다.
- Google Drive, Discord, GitHub 커넥터 덕분에 첫 동작 데모가 반나절이면 나온다.
- 가공이 파이프라인 안에서 끝나므로 요약과 키워드, 이미지 태그가 첫 조회 전에 준비된다.
- TypeScript SDK와 시작 프로젝트가 손으로 쓰는 GraphQL 양을 줄인다.
단점
- 저장소가 아카이브되었고 호스팅 앱은 꺼져 있다. 보안 패치도 버그 수정도 지원 창구도 없다.
- 문서 사이트가 더 이상 열리지 않아서 설치 세부 내용은 코드와 README, 오래된 블로그 글에서 모아야 한다.
- 당시 알파 소프트웨어였다. API가 버전마다 바뀌었고 일부 플러그인은 미완성으로 남았다.
- 직접 호스팅에는 Docker와 Node, Temporal 워커, OpenAI 키가 필요하고, 아무도 관리하지 않는 구성을 디버깅할 인내도 필요하다.
자주 묻는 질문
AI 기능을 위한 백엔드였다. Google Drive와 Discord 같은 소스에서 내용을 가져와 요약과 메타데이터를 붙이고, 벡터를 저장한 뒤 GraphQL API로 결과를 내보냈다. 용도는 시맨틱 검색과 문서 챗봇, 생성형 답변이었다.
관련 콘텐츠
Unbody와 관련된 도구, 스킬, 아티클을 살펴보세요.
Unbody 대안
Base Code
Base44 (Wix) · 코딩 · 생산성Base Code는 Base44가 만든 공유 클라우드 개발 환경이다. 팀은 기존 GitHub 저장소에 대한 변경을 채팅으로 설명하고, 미리보기로 확인한 뒤 풀 리퀘스트로 돌려보낸다.
Google EmbeddingGemma 2
Google DeepMind · 글쓰기 · 이미지 · 코딩Google EmbeddingGemma 2는 7억 4000만 파라미터의 오픈 모델로, 텍스트와 코드, 이미지, 오디오, 영상 프레임을 하나의 768차원 공간에 벡터로 바꿔 스마트폰과 노트북에서 실행한다.
GitGlow
GitGlow · 코딩 · 생산성GitGlow는 내 코드와 AI 에이전트의 변경을 한 리뷰에 모으는 데스크톱 Git 클라이언트다. 배포 전에 내 기계에서 무엇이 나가는지 확인할 수 있다.
