안녕하세요! 오늘은 2026년 2월 Deep Research 벤치마크 1위를 차지한 오픈소스 AI 플랫폼 Onyx에 대해 알아보겠습니다. Onyx는 MIT 라이선스로 무료 사용 가능한 Agentic RAG, Deep Research, Custom Agents, 50+ connectors 등 기업급 기능을 제공합니다. 특히 Deep Research 기능은 현재 leaderboard 최상위권을 기록하며 상용 서비스를 능가하는 성능을 보여줍니다. 이 글에서는 Onyx의 핵심 기능, Lite/Standard 배포 모드 비교, Docker 설치 방법, 실제 사용 예시, API 연동 방법까지 상세히 설명하겠습니다. 바로 시작해볼까요?
"이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다."
🤖 Onyx란 무엇인가?
Onyx는 Y Combinator가 백업한 오픈소스 AI 플랫폼입니다. 기업 내 모든 데이터 소스를 연결하여 Agentic RAG(검색 증강 생성)로 정확한 답변을 제공합니다. 단순한 챗봇이 아니라, Deep Research 기능으로 심층 조사 리포트를 생성하고, Custom Agents로 조직 특화 AI를 구축할 수 있습니다.
💡 핵심 특징:
- Agentic RAG: Hybrid Index + AI Agents로 최고 수준 검색 정확도
- Deep Research: 2026년 2월 벤치마크 leaderboard 1위 (Overall 54.92)
- 50+ Connectors: Slack, Google Drive, Confluence, GitHub 등 즉시 연결
- MCP 지원: Model Context Protocol로 외부 도구 확장
- MIT 라이선스: 무료 오픈소스, 상업적 사용 가능
⚙️ Onyx 핵심 기능 살펴보기
🔍 Agentic RAG: 최고 수준 검색 정확도
Onyx의 Agentic RAG는 Hybrid Index(벡터 + 키워드)와 AI Agents를 결합합니다. 단순히 문서를 검색하는 것에서 끝나지 않고, Agent가 정보를 수집, 분석, 통합하여 정확한 답변을 생성합니다. 곧 벤치마크 결과가 공개될 예정입니다.
Hybrid Index는 벡터 검색과 키워드 검색을 결합하여 의미적 유사성과 정확한 키워드 매칭을 동시에 제공합니다. 이는 단순 벡터 검색의 한계(키워드 누락)와 키워드 검색의 한계(의미 파악 실패)를 모두 해결합니다.
🔬 Deep Research: Leaderboard 1위 심층 조사
Deep Research 기능은 multi-step research flow로 심층 리포트를 생성합니다. 2026년 2월 Deep Research Benchmark에서 1위를 차지했습니다 (Overall 점수 54.92). 주어진 주제에 대해 웹 검색, 문서 분석, 정보 통합을 자동으로 수행합니다.
Deep Research의 작동 방식:
- 1단계: 주제 분석 및 검색 전략 수립
- 2단계: 웹 검색 + 내부 문서 검색 동시 수행
- 3단계: 정보 수집 및 필터링
- 4단계: AI Agent가 정보 분석 및 통합
- 5단계: 최종 리포트 생성 (출처 포함)
🤖 Custom Agents: 조직 특화 AI 구축
각 팀/프로젝트별로 고유한 지시사항, 지식 베이스, Actions를 가진 Agent를 생성합니다. 예: "HR Agent"는 인사 관련 문서만 검색, "Dev Agent"는 GitHub 코드만 참조.
Custom Agents 설정 방법:
- 지시사항(Instructions): Agent의 행동 규칙 정의
- 지식 베이스(Knowledge Base): 검색할 문서 소스 선택
- Actions: 외부 API 호출, 파일 생성 등 정의
- Tool 설정: Web Search, Code Execution 등 활성화
🌍 Web Search: 실시간 웹 정보 통합
Serper, Google PSE, Brave, SearXNG 등 다양한 웹 검색 엔진을 지원합니다. 자체 웹 크롤러와 Firecrawl/Exa 연동도 가능합니다.
📄 Artifacts & Code Execution
문서, 그래픽, 다운로드 가능한 파일을 생성합니다. Code Execution은 sandbox에서 코드를 실행하여 데이터 분석, 그래프 렌더링, 파일 수정을 수행합니다.
▶️ Actions & MCP: 외부 도구 연동
Onyx Agents가 외부 애플리케이션과 상호작용합니다. MCP(Model Context Protocol)를 통해 추가 도구를 확장할 수 있습니다. MCP는 Claude, Gemini, GPT 등 다양한 LLM과 호환됩니다.
🎙️ Voice Mode & Image Generation
TTS(Text-to-Speech)와 STT(Speech-to-Text)를 지원하여 음성 대화가 가능합니다. Image Generation은 AI 이미지 생성 기능을 제공하여 프레젠테이션, 마케팅 자료 등을 자동 생성합니다.
| 기능 | 설명 | 활용 예시 |
|---|---|---|
| Agentic RAG | Hybrid Index + AI Agents 검색 | 기업 문서 검색, 정확한 답변 |
| Deep Research | Multi-step 심층 조사 | 리포트 생성, 경쟁 분석 |
| Custom Agents | 팀별 특화 AI | HR Agent, Dev Agent |
| Web Search | 실시간 웹 정보 | 시장 조사, 뉴스 분석 |
| Artifacts | 파일 생성 | PDF, 이미지, 문서 |
| Code Execution | Sandbox 코드 실행 | 데이터 분석, 그래프 |
| Voice Mode | TTS/STT 지원 | 음성 대화 |
| Image Generation | AI 이미지 생성 | 프레젠테이션, 마케팅 |
| MCP Support | 외부 도구 확장 | Claude/Gemini/GPT 통합 |
🚀 배포 모드 비교: Lite vs Standard
Onyx는 Lite 모드와 Standard 모드를 제공합니다. Lite는 1GB 미만 메모리로 실행 가능한 간소화된 Chat UI입니다. Standard는 완전한 기능 세트로 기업 사용자에게 추천합니다.
| 비교 항목 | Lite 모드 | Standard 모드 |
|---|---|---|
| 메모리 | < 1GB | 4GB+ (Redis, MinIO 포함) |
| RAG | 기본 검색 | Vector + Keyword Index |
| Connectors | 제한적 | 50+ Connectors + Background Sync |
| Deep Research | 지원 | 지원 + AI Inference Server |
| 성능 최적화 | 없음 | Redis Cache + MinIO Blob Store |
| Code Execution | 없음 | Sandbox 실행 |
| 추천 사용자 | 개인, 테스트 | 팀, 기업 |
📌 Lite 모드 추천 시: 개인 사용, 빠른 테스트, Chat UI만 필요한 경우
📌 Standard 모드 추천 시: 팀 협업, 대규모 문서 RAG, 50+ connectors 사용, Enterprise 기능 필요
💡 Docker 설치 가이드 (초보자용)
1단계: 한 줄 명령어 설치
Onyx는 Docker로 한 줄 명령어로 설치할 수 있습니다.
# Onyx 설치 (Standard 모드)
curl -fsSL https://onyx.app/install_onyx.sh | bash
# Lite 모드로 설치 (저사양 서버)
curl -fsSL https://onyx.app/install_onyx.sh | bash -s -- lite
2단계: Docker Compose로 직접 실행
더 세밀한 제어를 위해 Docker Compose를 직접 사용할 수 있습니다.
# GitHub에서 클론
git clone https://github.com/onyx-dot-app/onyx.git
cd onyx
# Standard 모드 실행
docker compose up -d
# Lite 모드 실행
docker compose -f docker-compose.lite.yml up -d
3단계: LLM 설정
Onyx는 모든 주요 LLM을 지원합니다. Self-hosted 모델(Ollama, LiteLLM, vLLM)과 Proprietary 모델(Anthropic, OpenAI, Gemini) 모두 연동 가능합니다.
| LLM 유형 | 지원 목록 | 설정 방법 |
|---|---|---|
| Self-hosted | Ollama, LiteLLM, vLLM | API URL 설정 |
| Proprietary | Anthropic, OpenAI, Gemini | API Key 입력 |
4단계: Connectors 연동
50+ connectors 중 필요한 것을 선택하여 연동합니다. OAuth 인증 또는 API Key 방식으로 연결합니다.
# 예: Slack Connector 설정
# Onyx Admin UI → Connectors → Slack → Add
# Slack OAuth 인증 → 팀 채널 선택 → Sync 시작주요 Connectors 목록:
- 커뮤니케이션: Slack, Discord, Microsoft Teams
- 문서 저장: Google Drive, Dropbox, OneDrive, Box
- 개발: GitHub, GitLab, Jira, Confluence, Notion
- 데이터베이스: PostgreSQL, MySQL, MongoDB
- 웹: Web Crawler, Firecrawl, Exa
⚠️ 주의사항:
- Standard 모드는 Redis, MinIO가 필요합니다
- Deep Research는 AI Inference Server가 필요합니다
- Connectors Sync는 Background Worker가 실행되어야 합니다
🔗 API 연동 방법
Onyx는 REST API를 제공하여 외부 애플리케이션과 연동할 수 있습니다.
API 엔드포인트
# 기본 API 엔드포인트
POST /api/chat # 채팅 요청
POST /api/search # 검색 요청
POST /api/agent/create # Agent 생성
GET /api/connectors # Connectors 목록API 호출 예시
# 채팅 API 호출
curl -X POST http://localhost:8080/api/chat \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"message": "Onyx 문서를 검색해줘", "persona_id": 1}'🏢 Enterprise 기능
Onyx Enterprise Edition(EE)은 대규모 조직에 필요한 추가 기능을 제공합니다.
Enterprise 주요 기능:
- SSO: Google OAuth, OIDC, SAML 지원
- RBAC: Agents, Actions 등 리소스 권한 제어
- Analytics: 팀/LLM/Agents별 사용량 그래프
- Query History: AI 사용 감사
- Whitelabeling: 이름, 아이콘, 배너 등 커스터마이징
- Advanced Permissions: 문서 접근 권한 제어
Community Edition(CE)은 MIT 라이선스로 Chat, RAG, Agents, Actions 핵심 기능을 무료로 제공합니다.
📊 다른 기업용 RAG와 비교
| 비교 항목 | Onyx | Glean | Cortex |
|---|---|---|---|
| 라이선스 | MIT (무료) | 상용 (유료) | 상용 (유료) |
| Self-hosted | ✅ Docker/K8s | ❌ Cloud only | ⚠️ 제한적 |
| Connectors | 50+ | 100+ | 40+ |
| Deep Research | ✅ Leaderboard 1위 | ⚠️ 기본 | ❌ 없음 |
| MCP 지원 | ✅ | ❌ | ❌ |
| Custom Agents | ✅ 무제한 | ⚠️ 제한적 | ✅ |
| 가격 | 무료 (CE) | $100+/user/월 | $50+/user/월 |
⚠️ 한계점과 주의사항
🚨 Onyx 사용 시 주의사항:
- 설정 복잡성: Standard 모드는 Redis, MinIO 등 추가 컴포넌트 필요
- LLM 비용: Self-hosted는 무료지만, Proprietary API는 비용 발생
- Connectors 설정: 각 Connector별 OAuth 인증 필요
- Enterprise 기능: EE는 별도 라이선스 필요
- 한국어 지원: UI는 영어, 한국어 LLM은 별도 설정
- 초기 설정 시간: Connector Sync 완료까지 시간 소요
🎯 실제 활용 사례
기업 내부 지식 검색
HR, IT, Finance 문서를 통합 검색하여 "연차 신청 방법", "VPN 설정", "경비 처리" 등 질문에 즉시 답변합니다.
개발팀 코드 검색
GitHub, Confluence, Jira 연동으로 코드 문서화, PR 리뷰, 기술 문서를 통합 검색합니다.
시장 조사 및 경쟁 분석
Deep Research 기능으로 특정 주제의 리포트를 자동 생성합니다. 웹 검색 + 내부 문서 결합으로 심층 분석이 가능합니다.
고객 지원 자동화
Custom Agent로 FAQ, 제품 문서, 이전 대화 기록을 기반으로 고객 질문에 답변합니다.
🎯 맺음말
지금까지 Onyx에 대해 알아보았습니다. Onyx는 MIT 라이선스 무료 오픈소스, Deep Research Leaderboard 1위, 50+ Connectors, Agentic RAG, Custom Agents, MCP 지원 등 기업급 AI 플랫폼 기능을 제공합니다. 특히 Deep Research는 2026년 2월 벤치마크에서 최고 성능(Overall 54.92)을 입증했으며, 상용 서비스인 Glean, Cortex와 비교해도 Self-hosted, MCP 지원, 무료 라이선스 등에서 강력한 장점을 보여줍니다.
다만 Standard 모드 설정은 Redis, MinIO 등 추가 컴포넌트가 필요해 초보자에게 복잡할 수 있어 Lite 모드로 시작 후 필요 시 Standard로 전환하는 것이 추천됩니다.
여러분도 한번 Onyx를 Onyx Cloud에서 체험하거나 Docker로 로컬 설치해보시길 추천드리면서 저는 다음 시간에 더 유익한 정보를 가지고 다시 찾아뵙겠습니다. 감사합니다.
📚 참고 문헌 및 출처
- Onyx. (2026). Onyx - Open Source AI Platform. Retrieved from https://github.com/onyx-dot-app/onyx
- Onyx. (2026). Deep Research Benchmark. Retrieved from https://github.com/onyx-dot-app/onyx_deep_research_bench
- Onyx. (2026). Onyx Documentation. Retrieved from https://docs.onyx.app/welcome
- Elestio. (2026). Onyx: Free Open Source AI Platform. Retrieved from https://blog.elest.io/onyx-free-open-source-ai-platform-with-connectors-agents-knowledge-base/
- Y Combinator. (2026). Onyx: Open Source AI Chat. Retrieved from https://www.ycombinator.com/companies/onyx
'AI 도구' 카테고리의 다른 글
| 🚀 Claude Code 4 월 업데이트 총정리: Opus 4.7, Ultrareview, Routines 까지 (0) | 2026.05.01 |
|---|---|
| 🆓 Claude Design의 오픈소스 대안: Open Design으로 72개 디자인 시스템 무료 사용 (1) | 2026.05.01 |
| 🆓 HTML을 MP4 비디오로 변환: HeyGen HyperFrames 무료 오픈소스 완벽 가이드 (0) | 2026.04.28 |
| 🤖 Hermes Agent v2026.4.23 Interface Release - 119K 스타 오픈소스 자가 개선 AI 에이전트 (0) | 2026.04.28 |
| 🚀 Qwen3.6-Max-Preview: 6개 벤치마크 1위 달성한 알리바바 최신 플래그십 (0) | 2026.04.27 |
