Fireplexity - 오픈 소스 AI 스마트 검색 엔진

프로젝트 개요

Fireplexity는 Firecrawl 기술을 기반으로 개발된 오픈 소스 AI 검색 엔진으로, 실시간 인용, 스트리밍 응답 및 실시간 데이터 기능을 제공합니다. Perplexity AI의 오픈 소스 대안으로서, Fireplexity는 개발자가 타사 서비스에 의존하지 않고 자신만의 맞춤형 AI 검색 경험을 구축할 수 있도록 합니다.

핵심 기능

🔥 실시간 웹 지능형 검색

• Firecrawl API를 사용하여 JavaScript 렌더링 및 신뢰할 수 있는 웹 페이지 콘텐츠 크롤링 처리
• 지능형 알고리즘으로 콘텐츠 관련성 점수를 매겨 페이지에서 가장 중요한 정보 찾기
• JavaScript로 다시 로드되는 웹사이트를 포함한 복잡한 웹사이트 구조 크롤링 지원

🧠 인용이 포함된 스트리밍 AI 합성

• GPT-4o-mini를 사용하여 실시간으로 답변 생성, 모든 OpenAI 호환 엔드포인트 지원
• 스트리밍 기술로 답변 생성 과정을 실시간으로 표시
• 모든 진술에 검증 가능한 인용 지원

🔗 대화형 인용 시스템

• 모든 답변의 각 부분에 출처가 지원되며, 사용자는 마우스를 올리면 인용 내용을 미리 볼 수 있습니다.
• 즉각적인 인용 미리보기 기능으로 투명성과 신뢰도 향상
• 180개 이상의 회사에 대한 실시간 주식 차트 감지 기능 내장

🚀 프로덕션 준비 완료의 빠른 배포

• 5분 이내에 완전한 답변 엔진 배포 가능
• 벤더 종속 없음, 완전한 오픈 소스
• 모듈형 아키텍처로 확장 및 맞춤화 용이

기술 스택

프런트엔드 기술

• Next.js 15: 핵심 프레임워크로, 클라이언트 상호작용 및 서버 측 작업 처리, App Router 및 서버 사이드 렌더링 지원
• React: 대화형 사용자 인터페이스 구축
• Tailwind CSS: 유틸리티 우선 CSS 프레임워크
• shadcn/ui + Radix UI: 접근성 높은 UI 컴포넌트 라이브러리

백엔드 기술

• Firecrawl API: 핵심 웹 크롤러 및 검색 서비스
• Vercel AI SDK: AI 통합 및 스트리밍 응답 처리
• OpenAI API: 기본적으로 GPT-4o-mini 사용, 다른 호환 모델로 전환 지원

개발 도구

• TypeScript: 타입 안전성을 갖춘 JavaScript 상위 집합
• ESLint: 코드 품질 검사
• Prettier: 코드 포맷팅

설치 및 사용

빠른 시작

# 프로젝트 복제
git clone https://github.com/mendableai/fireplexity.git
cd fireplexity

# 의존성 설치
npm install

# 환경 변수 구성 파일 복사
cp .env.example .env.local

환경 변수 설정

.env.local 파일에 API 키를 추가하세요:

FIRECRAWL_API_KEY=fc-your-api-key
GROQ_API_KEY=gsk_your-groq-api-key

개발 서버 시작

npm run dev

http://localhost:3000 에 접속하여 애플리케이션을 확인하세요.

프로젝트 아키텍처

애플리케이션 구조

프로젝트는 Next.js의 App Router 구조를 채택하며, 라우팅은 폴더 구조와 직접적으로 일치합니다:

• /chat - 채팅 인터페이스 라우트
• /auth - 사용자 인증 라우트
• 자동 코드 분할, 온디맨드 로딩

핵심 컴포넌트

1. 검색 컴포넌트: 사용자 쿼리 입력 처리
2. 응답 스트림 컴포넌트: AI가 생성한 답변 실시간 표시
3. 인용 컴포넌트: 콘텐츠 출처 관리 및 표시
4. 주식 차트 컴포넌트: 실시간 금융 데이터 표시

데이터 흐름

1. 사용자 쿼리 입력 → Firecrawl 검색 API
2. 콘텐츠 크롤링 및 처리 → AI 모델 분석
3. 스트리밍 답변 생성 → 사용자에게 실시간 표시
4. 인용 링크 통합 → 대화형 미리보기

활용 사례

기업 내부 지식 기반

• 회사 내부 문서 또는 비공개 네트워크 콘텐츠 연결
• 팀에 직접적이고 인용이 포함된 답변 제공
• 정보 접근 속도 대폭 향상

전문 연구 도구

• 특정 분야(금융, 법률, 과학 연구)를 위한 전문 검색 엔진 구축
• 신뢰할 수 있는 출처에 집중하여 탁월한 정확성 제공
• 도메인별 쿼리 최적화 지원

맞춤형 검색 경험

• 검색 로직 및 사용자 인터페이스 완전 제어
• 타사 의존성 없음, 데이터 프라이버시 보호
• 특정 요구 사항에 따라 기능 확장 가능

오픈 소스 이점

완전한 제어

• 오픈 소스 코드로, 자신의 운명을 완전히 통제
• 모든 코드 라인을 검사하여 데이터 프라이버시 보장
• 무제한적인 맞춤화 능력

벤더 종속 없음

• 가격, 약관 또는 가용성이 변경될 수 있는 타사 서비스에 의존하지 않음
• 장기적인 안정성 및 지속 가능성
• 완전한 데이터 소유권

커뮤니티 주도

• 활발한 개발자 커뮤니티
• 지속적인 기능 개선 및 버그 수정
• 풍부한 문서 및 예시

비용 분석

주요 비용

• Firecrawl API: 월 $20부터 (2000 페이지)
• OpenAI API: GPT-4o-mini는 1000 토큰당 약 $0.15
• 호스팅 비용: 무료(Vercel hobby 플랜)부터 프로덕션 환경 월 $20-50

비용 이점

• 실제로 사용한 API 호출에 대해서만 비용 지불
• 추가 구독료 또는 사용자별 요금 없음
• 예측 가능한 운영 비용

확장성 및 맞춤화

모델 유연성

모든 OpenAI 호환 API 엔드포인트 지원:

• Claude
• Llama
• OpenAI 호환 인터페이스를 제공하는 기타 모델

UI 맞춤화

Next.js를 기반으로 구축되어 인터페이스의 모든 측면을 수정할 수 있습니다:

• 사용자 정의 테마 및 스타일
• 새로운 기능 컴포넌트 추가
• 타사 서비스 통합

기능 확장

모듈형 설계로 새로운 기능 추가 용이:

• 추가 데이터 소스 통합
• 사용자 정의 AI 처리 파이프라인
• 새로운 콘텐츠 유형 지원 추가

경쟁 제품과의 비교

vs Perplexity AI

• ✅ 완전한 오픈 소스, 블랙박스 없음
• ✅ 자체 배포, 데이터 프라이버시
• ✅ 사용 제한 없음
• ✅ 완전한 맞춤화

vs 기존 검색 엔진

• ✅ 링크 목록 대신 직접적인 답변
• ✅ AI 기반 콘텐츠 종합
• ✅ 실시간 인용 검증
• ✅ 문맥 이해 능력

라이선스

프로젝트는 MIT 오픈 소스 라이선스를 채택하며, 상업적 사용 및 자유로운 수정이 허용됩니다.

커뮤니티 및 지원

• GitHub 저장소: https://github.com/firecrawl/fireplexity
• Firecrawl Discord 커뮤니티: 도움을 받고 맞춤형 콘텐츠 공유
• 문서: 완벽한 API 문서 및 사용 가이드
• 예시 프로젝트: 풍부한 애플리케이션 예시 및 템플릿

결론

Fireplexity는 개발자가 필요한 도구가 구축될 때까지 기다릴 필요 없이, 맞춤형 AI 검색 경험을 구축할 수 있는 완전한 도구 키트를 제공합니다. 첨단 웹 크롤링 기술, 지능형 콘텐츠 선택 및 스트리밍 AI 합성을 결합하여, Fireplexity는 프로덕션 수준의 AI 답변 엔진 구축을 손쉽게 만듭니다. 기업 내부 지식 기반, 전문 연구 도구 또는 특정 도메인 답변 엔진 등 어떤 경우에도 Fireplexity는 견고한 기술 기반을 제공합니다.