핵심 요점
- Onyx Community Edition은 MIT 하에 오픈소스이며, 소스 저장소는 github.com/onyx-dot-app/onyx
- 이전에는 Danswer라는 이름으로 배포; 동일한 코드베이스, GitHub 커밋 이력, Y Combinator W24 지원이 새 이름 Onyx 아래 이어졌음—이는 포크나 다른 제품이 아니라 명칭 변경임
- Ollama를 모델 제공업체로 추가하여 로컬 모델에 연결; 동일한 설정 화면을 통해 OpenAI, Anthropic, Gemini 등 클라우드 제공업체에도 연결
- 50개 이상의 내장 커넥터(Slack, Confluence, Google Drive, GitHub, Notion, Jira 등) 및 외부 도구를 위한 모델 컨텍스트 프로토콜(MCP) 지원
- Community Edition(CE)은 채팅, RAG, 에이전트, 액션을 무료로 제공; Enterprise Edition(EE)은 별도의 독점 라이선스 하에 SSO, 역할 기반 접근 제어, 분석, 화이트라벨링 추가
- 원라인 설치 스크립트,
uv tool install onyx-cliCLI, Docker Compose, Kubernetes 또는 Helm으로 설치 가능 - 이 리뷰 작성 시점 기준 GitHub 스타 약 32,000개
📍 한 문장으로
Onyx는 오픈소스 자체 호스팅 엔터프라이즈 검색·RAG 어시스턴트로, 이전에 Danswer라 불리던 프로젝트의 명칭 변경 후 이어진 것이며, 50개 이상의 데이터 소스와 로컬 Ollama 또는 클라우드 모델에 연결되며, 무료 MIT 라이선스 Community Edition과 유료 Enterprise Edition을 제공합니다.
💬 쉽게 말하면
Slack, Confluence, Google Drive를 따로따로 검색하는 대신, 이들 전부를 한 번 Onyx에 연결한 뒤 자연어로 질문할 수 있습니다. Ollama를 통해 Onyx를 로컬 모델로 지정하면, 검색 인덱스, 가져온 문서, 답변을 생성하는 모델 모두 자신이 관리하는 인프라에 남길 수 있습니다.
📌참고: 이 리뷰는 로컬 LLM 소프트웨어 디렉터리에 등록된 Onyx 항목의 심층 버전입니다 — Onyx를 수십 개의 다른 로컬 AI 도구와 한눈에 비교하려면 해당 페이지를 참고하십시오.
Onyx란 무엇인가?
Onyx는 대규모 언어 모델을 위한 자체 호스팅 애플리케이션 계층입니다. 자체 GitHub 설명에 따르면 "누구나 쉽게 호스팅할 수 있는 기능이 풍부한 인터페이스를 제공"합니다. 연결된 데이터 소스 전반에 걸친 엔터프라이즈 검색, 검색 증강 생성, 맞춤형 에이전트, 도구를 사용하는 "액션"을 스스로 조립해야 하는 코드 우선 프레임워크가 아니라 하나의 호스팅 애플리케이션으로 통합합니다.
- 핵심 기능: 50개 이상의 연결된 소스에서 문서를 인덱싱한 뒤, 채팅을 통해 해당 인덱스에 대해 자연어 질문에 답하며 원본 문서로의 인용을 함께 제공
- 모델 접근: Onyx 자체 문서에 따르면 제공업체에 구애받지 않음—자체 호스팅 옵션(Ollama, LiteLLM, vLLM)과 독점 제공업체(OpenAI, Anthropic, Gemini) 모두에 연결
- 개발사: onyx-dot-app, Y Combinator Winter 2024(W24) 배치의 지원을 받는 회사; 이 프로젝트는 Hacker News에 "Onyx(YC W24)—오픈소스 채팅 UI"로 공개 출시됨
- 공식 저장소: github.com/onyx-dot-app/onyx—Onyx의 소스코드, 이슈 트래커, 릴리스 노트의 활성 본거지; 완전 오픈소스(FOSS) 빌드를 위해 별도지만 관련된 저장소 github.com/onyx-dot-app/onyx-foss도 존재함
Onyx는 Danswer와 같은 프로젝트인가?
예. Onyx는 원래 Danswer라는 이름으로 배포되었던 오픈소스 프로젝트의 명칭 변경 후 연속이며, 별도의 포크나 경쟁 제품이 아닙니다. 명칭 변경으로 코드베이스, GitHub 커밋 이력, 회사 지원이 새 이름 아래 그대로 이어졌습니다.
- Danswer는 Slack, GitHub, Confluence 같은 서비스에 연결하는, "자연어로 질문하고 비공개 소스에 기반한 답변을 얻는" 오픈소스 도구로 출시됨
- 프로젝트는 Onyx로 리브랜딩되었으며, 프로젝트 GitHub 이력에서 확인되는 변경 사항에 따라 전환 과정에서 내부 환경 변수와 코드 식별자가
DANSWER_*접두사에서ONYX_*로 변경됨 - 프로젝트를 뒷받침하는 회사는 Y Combinator Winter 2024(W24) 배치의 지원을 받고 있음—이는 명칭 변경 이전부터 존재했고 변경 이후에도 이어진 사실임
- 명칭 변경 이전 코드베이스의 오래된 미러와 포크—예를 들어 unoplat/danswer—는 여전히 옛 이름으로 GitHub에 남아 있으나, 이들은 현재 프로젝트의 활발히 유지 관리되는 연속판이 아님
Onyx를 어떻게 자체 호스팅하나?
Onyx의 문서화된 빠른 설치 방법은 Docker 설정을 자동으로 처리하는 원라인 스크립트이거나, 더 세밀한 제어가 가능한 전용 CLI 도구입니다. 두 방법 모두 검색 인덱스와 데이터베이스를 포함한 전체 애플리케이션 스택을 설치합니다.
- 1설치 방법 선택: 원라인 스크립트 또는 전용 CLI.
Why it matters: 원라인 스크립트(Linux/macOS에서는 `curl -fsSL https://onyx.app/install_onyx.sh | bash`, Windows에서는 동등한 PowerShell 명령)는 Docker가 없으면 자동으로 설치합니다. CLI(`uv tool install onyx-cli && onyx-cli deploy install`)는 더 많은 제어를 제공하며 Onyx 자체가 문서화한 권장 방법입니다. - 2설치 프로그램을 실행하고 프롬프트가 나타나면 배포 모드—Lite 또는 Standard—를 선택.
Why it matters: 설치 프로그램은 진행하기 전에 시스템 리소스와 요구 사항을 확인하며, 선택한 모드에 따라 어떤 선택적 구성 요소(예: 추가 검색 인프라)가 배포될지 결정됩니다. - 3설치 프로그램이 완료되면 보고된 로컬 URL을 브라우저에서 열어 초기 설정을 완료하고 관리자 계정을 만듦.
Why it matters: 이는 대부분의 자체 호스팅 웹 애플리케이션에서 사용되는 것과 동일한 최초 실행 패턴입니다: 컨테이너 스택이 시작된 후 설정 파일이 아닌 웹 UI를 통해 구성합니다. - 4관리자 설정에서 모델 제공업체 추가—로컬 모델용 Ollama 또는 클라우드 제공업체(API 키 필요).
Why it matters: Onyx는 자체 추론 엔진이 없습니다. 채팅이나 RAG 기능이 질문에 답하려면 로컬이든 클라우드든 모든 모델을 별도의 제공업체 항목으로 추가해야 합니다. - 5커넥터 섹션에서 하나 이상의 데이터 소스를 연결한 후, 질문하기 전에 Onyx가 인덱싱하도록 함.
Why it matters: 검색 품질은 무엇이 연결되고 인덱싱되었는지에 달려 있습니다—Onyx는 연결되지 않은 데이터 소스에 대한 질문에는 답할 수 없습니다.
Onyx는 로컬 Ollama 모델에 어떻게 연결하는가?
Onyx는 모델 추론을 직접 실행하지 않습니다. 관리자 설정의 모델 제공업체 항목을 통해 별도로 실행 중인 로컬 추론 서버(가장 흔히 Ollama)에 연결합니다. 로컬 모델을 사용하려면 먼저 해당 모델을 Ollama에 다운로드한 뒤 Onyx 내에서 등록합니다.
- Onyx의 관리자 패널에서 LLM 제공업체 아래 새 제공업체를 추가하고 Ollama(또는 OpenAI 형식과 호환되는 엔드포인트)를 선택
- Ollama 서버의 주소를 입력(예: 로컬 설치의 경우
http://localhost:11434, Ollama가 다른 머신에서 실행 중이면 LAN/원격 주소) - Ollama가 제공하는 것과 일치하는 모델 이름을 입력
- 추가 후 로컬 모델은 연결된 모든 클라우드 모델과 나란히 표시되며, 검색 어시스턴트나 에이전트가 동일하게 사용할 수 있음
- Onyx는 동일한 일반적인 제공업체 패턴을 사용하는 대체 자체 호스팅 백엔드로 LiteLLM과 vLLM도 문서화하고 있음
Onyx로 무엇을 만들 수 있나?
Onyx의 기능은 흩어진 조직 지식을 단일하고 검색 가능하며 대화형인 인터페이스로 전환하는 데 중점을 둡니다. 아래 세부 내용은 Onyx 자체의 GitHub README와 문서를 기반으로 합니다.
- 엔터프라이즈 검색—Onyx 자체 설명에 따른 하이브리드 인덱스로, 연결된 모든 소스에서 키워드 검색과 시맨틱 검색을 결합하여 수천만 건 규모의 문서에서도 정확성을 유지하도록 설계됨
- 50개 이상의 커넥터—Slack, Confluence, Google Drive, GitHub, Notion, Jira 등 서비스에 대한 내장 커넥터로, 기존 조직 지식을 수동으로 다시 업로드할 필요가 없음
- 에이전트형 RAG와 심층 리서치—단일 턴 질의응답뿐 아니라 다단계 검색 및 추론 워크플로. Onyx 자체 기능 설명에 따름
- 웹 검색 통합—내부 문서 검색과 함께 실시간 웹 결과를 위해 Serper, Google Programmable Search Engine, Brave 또는 SearXNG에 연결
- 맞춤형 에이전트와 액션—특정 지침과 지식을 가진 에이전트를 구성하고, 도구를 사용하는 에이전트형 워크플로를 위해 MCP 기반 도구를 포함한 "액션"을 연결
- 코드 실행과 파일 생성—Onyx의 현재 기능 목록에 따른 샌드박스화된 코드 실행 및 문서/산출물 생성
- 음성 모드와 이미지 생성—텍스트 채팅을 넘어선 추가 모달리티. Onyx 자체 문서에 따름
Onyx 라이선스: Community와 Enterprise 비교
Onyx Community Edition(CE)은 MIT 라이선스 하에 무료·오픈소스이며 핵심 채팅, RAG, 에이전트, 액션 기능을 포함합니다. Enterprise Edition(EE)은 별도의 독점 라이선스 하에 더 큰 조직을 겨냥한 기능을 추가합니다.
에디션 | 라이선스 | 가격 | 주요 기능 |
|---|---|---|---|
| Community(CE) | MIT | 무료 | 채팅, RAG, 에이전트, 액션, 50개 이상의 커넥터 |
| Enterprise(EE) | 독점 | 영업팀 문의 | SSO, 역할 기반 접근 제어, 분석, 화이트라벨링 |
이 리뷰 작성 시점 기준 onyx.app에는 Enterprise Edition의 가격이 고정된 숫자로 공개되어 있지 않습니다—엔터프라이즈 등급 가격은 일반적으로 영업 상담이 필요하며 예고 없이 변경될 수 있으므로 현재 조건은 공식 사이트에서 직접 확인하십시오.
Onyx는 누구에게 적합한가?
Onyx는 다수의 기존 도구에 걸친 단일 검색·채팅 인터페이스를 원하면서, 모델 추론을 로컬에 유지할 수 있는 옵션을 원하는 조직에 적합합니다.
Onyx vs. MaxKB, AnythingLLM, PrivateGPT
Onyx는 다른 여러 자체 호스팅 RAG 및 문서 검색 플랫폼과 겹치는 부분이 있습니다—차이는 커넥터 범위, 라이선스, 기능 세트가 엔터프라이즈를 얼마나 지향하는지에 있습니다.
도구 | 인터페이스 | 라이선스 | 가장 적합한 용도 |
|---|---|---|---|
| Onyx | 엔터프라이즈 검색 + RAG + 에이전트 | MIT(CE) + 독점(EE) | 50개 이상의 커넥터, 대규모 문서에서의 하이브리드 검색 |
| MaxKB | Web UI + RAG + 에이전트 | GPL-3.0 | 로컬 모델을 지원하는 Docker 배포형 RAG/에이전트 플랫폼 |
| AnythingLLM | 채팅 + RAG | MIT | 가벼운 자체 호스팅 문서 채팅 |
| PrivateGPT | Web + CLI, 완전 오프라인 RAG | Apache 2.0 | 완전 오프라인, 엔터프라이즈 지향 문서 RAG |
네 가지 도구 모두 로컬 모델에 연결할 수 있습니다: Onyx, MaxKB, AnythingLLM은 모두 Ollama를 모델 제공업체로 추가합니다. PrivateGPT는 기본적으로 완전 오프라인으로 실행되도록 설계되었습니다. 이 넷 중 Onyx의 주요 차별점은 로컬 파일 업로드뿐 아니라 기존 조직 도구를 인덱싱하기 위한 50개 이상의 내장 커넥터 라이브러리입니다.
Onyx 평가 시 흔한 실수
자주 묻는 질문
Onyx는 무료인가요?
Community Edition(CE)은 MIT 라이선스 하에 무료·오픈소스이며 채팅, RAG, 에이전트, 액션, 50개 이상의 커넥터를 포함합니다. 별도의 Enterprise Edition(EE)은 독점 라이선스와 별도 가격 하에 SSO, 역할 기반 접근 제어, 분석, 화이트라벨링을 추가합니다.
Onyx는 Danswer와 같은 것인가요?
예. Onyx는 원래 Danswer라는 이름으로 배포되었던 프로젝트의 명칭 변경 후 연속입니다—동일한 코드베이스, GitHub 이력, Y Combinator(W24) 지원이 이어졌으며, 전환 과정에서 내부 식별자가 DANSWER_*에서 ONYX_*로 변경되었습니다.
Onyx는 어떤 라이선스를 사용하나요?
공식 GitHub 저장소(github.com/onyx-dot-app/onyx)의 LICENSE 파일에 따르면 Community Edition은 MIT 라이선스입니다. Enterprise Edition(EE)은 독점이며 별도로 라이선스가 부여됩니다.
Onyx는 Ollama 같은 로컬 모델을 지원하나요?
예. Onyx는 관리자 설정에서 Ollama를 모델 제공업체로 추가하여 로컬 모델에 연결합니다—서버 주소와 모델 이름을 입력하면 Onyx는 Ollama가 제공하는 모델로 요청을 라우팅합니다. LiteLLM과 vLLM도 대체 자체 호스팅 백엔드로 문서화되어 있습니다.
Onyx는 어떻게 설치하나요?
Docker를 자동으로 설정하는 원라인 설치 스크립트(curl 또는 PowerShell)를 사용하거나, 더 많은 제어를 위해 전용 onyx-cli 도구(uv tool install onyx-cli && onyx-cli deploy install)를 사용합니다. 더 큰 규모의 배포를 위해 Onyx는 Kubernetes와 Helm도 지원합니다.
Onyx는 누가 개발하나요?
Onyx는 Y Combinator Winter 2024(W24) 배치의 지원을 받는 회사인 onyx-dot-app이 개발합니다. 이 프로젝트는 명칭 변경 전에는 Danswer라는 이름으로 배포되었습니다.
Onyx는 얼마나 인기가 있나요?
이 리뷰 작성 시점 기준 Onyx의 GitHub 저장소는 약 32,000개의 스타를 기록하고 있습니다.
Onyx의 주요 대안은 무엇인가요?
MaxKB(GPL-3.0, Docker 배포형 RAG/에이전트 플랫폼), AnythingLLM(MIT, 더 가벼운 자체 호스팅 문서 채팅), PrivateGPT(Apache 2.0, 완전 오프라인·엔터프라이즈 지향 RAG)가 가장 가까운 자체 호스팅 대안입니다.