← 목록으로

AI의 자율 연구개발이 그렇게 독창적이라는 말을 믿기 어렵다

요약
  • Firenook은 Java 설치 없이 사용 가능한 Firebase Local Emulator Suite 대체 도구로, 기존 Firebase 프로젝트와 높은 호환성을 유지합니다.
  • 자체 벤치마크에서 공식 에뮬레이터 대비 월등한 속도와 낮은 메모리 점유율을 기록했으며, Firestore와 Authentication 등 8개 서비스를 지원하는 무료 오픈소스 프로젝트입니다.
  • Firenook은 기존 firebase.json, SDK, 포트와 실행 옵션을 유지하면서 Firebase Local Emulator Suite를 대체하는 도구로, Java 설치 없이 사용 가능함
  • 실제 운영 앱의 트래픽을 각각 2시간 실행한 자체 벤치마크에서 쓰기 중앙값은 공식 에뮬레이터의 208.2ms 대비 5.1ms, 최대 메모리는 22.57GiB 대비 2.11GiB였음
  • Firestore, Authentication 등 8개 서비스를 지원하지만 Realtime Database, Hosting, App Hosting, Data Connect는 에뮬레이션하지 않음
  • --keep-data 로 Firestore, Auth, Storage 데이터를 재시작 후에도 유지하며, 매번 내보내기와 가져오기를 수행하지 않고 약 0.5초에 다시 시작할 수 있음
  • 모든 지원 서비스를 확인하는 로컬 콘솔과 코딩 에이전트용 MCP 도구 54개를 제공하는 무료 오픈소스 프로젝트임
기존 Firebase 프로젝트와의 호환성
  • 실행 명령의 firebase를 firenook으로 바꾸는 방식으로 전환하며, 기존 플래그, 포트, 내보내기 형식을 유지함
    • firebase.json과 .firebaserc를 Firebase CLI와 같은 방식으로 읽음
    • Security Rules, 인덱스, Functions 코드와 설정을 그대로 사용함
    • connectFirestoreEmulator, FIRESTORE_EMULATOR_HOST 등 기존 SDK 연결 방식을 변경하지 않아도 됨
  • 공식 데이터 형식의 가져오기와 내보내기를 양방향으로 지원하므로 공식 에뮬레이터로 돌아갈 수 있음
    • Firenook 실행 중 데이터를 내보낸 뒤 공식 에뮬레이터에서 --import로 읽으면 됨
  • firebase-tools는 계속 필요함

    • Firenook은 에뮬레이터만 대체하며 배포나 로그인 명령은 제공하지 않음
지원하는 8개 서비스와 제외 범위
  • Firestore 는 네이티브/웹 SDK, 실시간 리스너, Security Rules, 이름이 지정된 데이터베이스, 공식 가져오기/내보내기를 지원함
  • Authentication 은 비밀번호, 이메일 링크, 전화, MFA, 패스키, 테넌트, 차단 함수 등 공식 Auth 에뮬레이터의 모든 작업을 지원함
  • Cloud Storage 는 Firebase 및 Cloud Storage API를 지원하며, firestore.get()을 포함한 Security Rules를 네이티브로 평가함
  • Cloud Functions 는 HTTP, 호출형, 스트리밍 함수와 Firestore, Storage, Auth, Pub/Sub, Eventarc, 예약 실행, 작업 큐 트리거를 지원함
    • 코드 저장 시 다시 로드함
  • Pub/Sub 는 gRPC와 HTTP/JSON의 모든 RPC를 지원함
    • 푸시, 순서 지정, 필터, 데드 레터 토픽, seek, 스냅샷, 스키마를 포함함
  • Cloud Tasks 는 onTaskDispatched용 큐와 공식 재시도/처리율 제한 동작을 지원함
  • Eventarc 는 onCustomEventPublished로 전달하는 사용자 정의 이벤트와 Firebase 서비스 자체 이벤트를 지원함
  • Extensions 는 로컬, 프로젝트에 포함한 소스, 레지스트리 소스를 지원하며, 소스를 프로젝트에 포함한 뒤에는 오프라인으로 사용할 수 있음
  • Realtime Database, Hosting, App Hosting, Data Connect는 지원하지 않음

    • 해당 서비스가 firebase.json에 설정되어 있어도 경고를 출력하고 시작함
    • 서비스별 세부 범위는 호환성 문서에서 확인 가능함
실제 앱 트래픽으로 측정한 성능
  • 자체 벤치마크에서는 Firestore 문서 211,205개와 Storage 데이터 6.7GB를 보유한 운영 앱의 트래픽을 각 에뮬레이터에 2시간씩 실행함
    • 두 에뮬레이터를 같은 서버에서 번갈아 실행하고 클라이언트에서 각 작업 시간을 측정함
    • 측정 방식은 벤치마크 문서에 공개함
  • 쓰기 중앙값은 약 40배 빨랐고 최대 메모리 사용량은 약 10분의 1이었음
    • 쓰기 중앙값은 공식 208.2ms, Firenook 5.1ms였음
    • 최대 메모리 사용량은 공식 22.57GiB, Firenook 2.11GiB를 기록함
  • 리스너 갱신과 쿼리 지연시간도 줄어듦
    • 리스너 갱신 중앙값은 공식 209ms, Firenook 11ms로 약 19배 빨랐음
    • orderBy와 limit 20 쿼리는 공식 96.3ms, Firenook 12.0ms로 약 8배 빨랐음
    • 26개 쿼리 형태 중 25개에서 더 빨랐고 나머지 1개는 동률이었음
  • 데이터를 유지한 재시작은 공식 30.8초 대비 0.59초로 약 52배 빨랐음
  • 2시간 동안의 CPU 사용 시간은 공식 1,586초 대비 616초로 61% 줄어듦
데이터 유지와 테스트 실행
  • --keep-data 를 추가하면 Firestore, Auth, Storage 데이터를 유지하며, 수백만 개의 문서가 있어도 약 0.5초에 재시작할 수 있음
    • 매 종료 시 내보내기, 매 시작 시 가져오기를 수행하지 않음
    • 비정상 종료 시 최대 마지막 1초의 쓰기를 잃을 수 있으며, 공식 에뮬레이터는 마지막 내보내기 이후의 데이터를 잃음
    • 정상 종료 시에는 데이터를 안전하게 닫음
  • 종료와 시작 시간 비교에서 공식 에뮬레이터의 내보내기 포함 종료는 50~57초, 가져오기 포함 시작은 21.6~23.6초였음
    • Firenook은 종료에 0.04~0.30초, 시작에 0.54~0.57초가 걸림
  • 0.2.0 데모는 이전 실행에서 보존한 문서 120만 개, 사용자 64,000명, 파일 5,400개로 시작함
    • 주문 2건을 처리하고 실패한 웹훅의 스택 추적을 보여줌
  • emulators:exec 는 전체 에뮬레이터 준비 후 환경 변수를 설정해 명령을 실행하고, 종료 시 에뮬레이터를 멈춘 뒤 명령의 종료 코드를 전달함
    • CI에는 공식 에뮬레이터와 같은 일반 텍스트 로그를 출력하며 Java 설정이 필요하지 않음
    • 0.2.0 데모 프로젝트의 테스트 실행은 시작부터 종료까지 테스트를 포함해 1.39초였음
모든 서비스용 로컬 콘솔
  • Firenook 콘솔은 실행하는 모든 서비스를 기존 Emulator UI 포트에서 실시간으로 보여줌
    • Google Emulator UI에는 Functions, Pub/Sub, Cloud Tasks, Eventarc 전용 페이지가 없고 로그만 있음
    • 함수 호출별 트리거, 결과, 실행 시간, 로그를 확인할 수 있음
  • 밝은 테마와 어두운 테마, 오프라인 사용을 지원하며 외부로 데이터를 보내지 않음
    • 공식 UI 페이지의 북마크는 대응하는 Firenook 콘솔 페이지로 연결됨
    • 화면별 기능은 콘솔 문서에서 확인 가능함
코딩 에이전트용 MCP 도구
  • firenook mcp 는 실행 중인 에뮬레이터에 접근하는 도구 54개를 제공하며, 데이터는 로컬 머신을 벗어나지 않음
    • 로그와 함수 호출 오류를 읽고, Security Rules의 요청 거부 원인을 확인하며 데이터를 조작할 수 있음
    • firenook mcp add는 프로젝트 파일에 Claude Code, Cursor, VS Code용 설정을 추가함
    • 다른 에이전트는 npx firenook mcp로 연결할 수 있으며, 에이전트 사용 문서를 제공함
  • 서비스별 도구는 조회뿐 아니라 수정과 재실행도 지원함
    • Firestore: 문서 읽기, 쿼리, 개수 계산, 쓰기, 삭제가 가능함
    • Authentication: 사용자 관리, 로그인 코드 조회, ID 토큰 발급, 클레임 설정이 가능함
    • Storage: 파일 목록 조회, 읽기, 업로드, 복사, 이동, 삭제가 가능함
    • Functions와 로그: 함수 호출, 호출별 기록과 로그 조회, 수정 후 호출 재생이 가능함
    • Security Rules: 거부 원인 확인, 규칙 초안 테스트, 거부 목록 조회가 가능함
    • Pub/Sub, Tasks, Eventarc: 게시, 메시지 들여다보기, 작업과 예약 실행의 즉시 수행, 이벤트 재생이 가능함
  • 데모 도구 실행 결과에서는 실패한 Stripe 웹훅의 500 응답과 서명 불일치 오류, 코드 위치를 조회함
    • Storage 쓰기 요청에 대해서는 미인증 상태의 거부 판정과 해당 규칙 줄을 확인함
    • 질문은 예시이며 도구 호출과 응답은 0.2.0 데모 프로젝트의 실제 실행 결과임
실행 환경과 공개 상태
  • 네이티브 서비스를 하나의 npm 패키지로 제공하며, 설치나 시작 시 추가 다운로드가 없음
    • macOS, Linux, Windows용 엔진을 제공함
    • 전환 안내의 실행 환경은 Node 22/24/26, Linux glibc 2.28 이상, Windows x64임
    • Functions도 프로덕션과 마찬가지로 Node 22/24/26에서 실행함
  • 기존 프로젝트 점검은 firenook init --adopt --dry-run으로 수행하며 파일을 변경하지 않음
    • 새 프로젝트는 firenook init으로 생성할 수 있음
  • 0.2.0이 첫 공개 사용 릴리스이며, 모든 릴리스에서 공식 에뮬레이터와의 적합성 재생 검증 및 5개 플랫폼의 패키지 설치 검증을 수행함
    • 팀 사용 시 잠금 파일을 커밋하고 의도적으로 버전을 올릴 것을 권장함
  • Apache License 2.0의 무료 오픈소스 독립 프로젝트이며, Google과 제휴 관계가 없고 Google의 보증을 받지 않음
그냥 목록으로
원문 보기 ↗