Enable Chrome AI: 크롬 브라우저에 내장된 Gemini Nano 모델을 활성화하는 오픈소스 도구

읽을거리&정보공유
, , ,
1

Enable Chrome AI: 크롬 브라우저에 내장된 Gemini Nano 모델을 활성화하는 오픈소스 도구
Enable Chrome AI: 크롬 브라우저에 내장된 Gemini Nano 모델을 활성화하는 오픈소스 도구1002×958 87.3 KB

Enable Chrome AI 소개

Enable Chrome AI는 Google Chrome 브라우저에 내장된 인공지능 기능(Built-in AI, Gemini Nano 등)을 강제로 활성화해주는 오픈소스 Python 도구입니다.

Google은 최근 Chrome 브라우저에 로컬 AI 모델인 Gemini Nano를 탑재하고, 이를 활용한 'AI 기반 방문 기록 검색(AI Powered History search)'이나 'DevTools AI 혁신' 같은 기능들을 도입하고 있습니다. 하지만 이러한 기능들은 현재 특정 국가(주로 미국)나 특정 사용자 그룹에 한해 제한적으로 제공되거나, 복잡한 플래그(Flag) 설정이 필요한 경우가 많습니다.

image
image820×566 87.3 KB

Enable Chrome AI 도구는 사용자의 Chrome 프로필 데이터(Local State)를 직접 수정하여 지역 제한을 우회하고 AI 관련 기능이 활성화되도록 패치(Patch)합니다. 복잡한 브라우저 설정을 일일이 찾아서 변경할 필요 없이 스크립트 실행 한 번으로 내장 AI 기능을 켤 수 있게 도와줍니다.

Google은 'Built-in AI'라는 이름으로 브라우저 자체에 LLM을 내장하여, 서버 통신 없이도 프라이버시를 보호하며 빠른 추론이 가능한 환경을 구축하고 있습니다. 이 도구는 이러한 환경을 개발자들이나 얼리어답터들이 미리 체험해 볼 수 있도록 돕는 역할을 합니다.

Enable Chrome AI vs. 기존의 수동 설정 방식 비교

기존에 Chrome 내장 AI를 활성화하기 위해서는 다음과 같은 복잡한 과정이 필요했습니다.

  • 기존 수동 방식:
  1. chrome://flags에 접속하여 Optimization Guide On Device Model, Prompt API for Gemini Nano 등 여러 플래그를 찾아 수동으로 'Enabled' 상태로 변경.
  2. chrome://components에서 모델 다운로드를 반복적으로 시도.
  3. IP가 미국이 아닌 경우 활성화가 되지 않아 VPN을 사용해야 하는 번거로움.
  • Enable Chrome AI 사용 시:
  • Python 스크립트가 자동으로 로컬 설정 파일을 수정하여 국가 코드를 'US'로 변경하고, AI 기능 적합성(GLIC eligible) 체크를 강제로 통과시킵니다.
  • 별도의 VPN이나 복잡한 플래그 탐색 없이 즉시 기능을 활성화할 수 있습니다.

Enable Chrome AI 설치 및 사용 가이드

Enable Chrome AI 도구는 Chrome의 Local State 파일을 수정하여 AI 기능을 활성화합니다. 사용 전 데이터 백업을 권장합니다.

시스템 요구 사항 (Requirements)

  • Python: 3.13 이상 버전이 필요합니다.
  • Chrome: Google Chrome이 설치되어 있어야 합니다. (Stable, Canary, Dev, Beta 모든 채널 지원)
  • OS: Windows, macOS, Linux를 지원합니다.

설치 및 실행 방법 (Quick Start)

Enable Chrome AI 프로젝트는 최신 Python 패키지 관리 도구인 uv를 권장하지만, 일반적인 pip로도 실행 가능합니다.

먼저, uv가 설치되어 있다면 의존성 관리와 가상 환경 설정이 자동으로 처리됩니다. 이 과정은 다음과 같이 수행할 수 있습니다:

# 저장소 복제
git clone https://github.com/lcandy2/enable-chrome-ai
cd enable-chrome-ai

# 의존성 설치 및 동기화
uv sync .

# 스크립트 실행
uv run main.py .

이 때, 패치가 진행되는 동안 Chrome이 자동으로 종료됩니다. 재시작 후 엔터 키를 누르면 완료됩니다.


만약 사용자의 컴퓨터에 uv가 설치되어 있지 않거나, 사용하지 않는 경우, 수동으로 의존성을 설치해야 합니다:

# 저장소 복제
git clone https://github.com/lcandy2/enable-chrome-ai
cd enable-chrome-ai

# (선택 사항) 가상 환경(venv) 생성 및 활성화

# 의존성 라이브러리(`psutil`) 설치:
python -m pip install psutil

# 스크립트 실행:
python main.py .

Enable Chrome AI 동작 원리

위 설치 스크립트를 실행하면 내부적으로 다음과 같은 작업이 순차적으로 수행됩니다:

  1. Chrome 프로세스 종료: 파일 잠금(File lock) 문제를 방지하기 위해 실행 중인 Chrome 프로세스(Stable/Canary/Dev/Beta)를 감지하여 종료합니다.

  2. 프로필 경로 탐색: OS별(Windows, macOS, Linux) 기본 경로에서 Chrome 사용자 데이터 폴더를 찾습니다.

  3. Local State 패치: Local State JSON 파일을 열어 다음 값들을 수정합니다:

    • is_glic_eligible: 모든 항목에 대해 true로 설정 (AI 기능 적합성 강제 부여).
    • variations_country: "us"로 설정 (지역 제한 우회).
    • variations_permanent_consistency_country: ["<version>", "us"]로 설정.

  4. 복구 및 재시작: 패치 이전에 실행 중이던 Chrome 빌드를 다시 실행합니다.

:warning: 주의 사항 및 한계 (Caveats) :warning:

Enable Chrome AI 도구를 사용할 때, 다음과 같이 주의 사항들이 있습니다:

  • macOS: 프로세스 감지가 이름 기반(Google Chrome*)으로 작동하여, Chrome과 관련된 다른 프로세스가 함께 종료될 수 있습니다.

  • Linux: 실행 파일명이 chrome이라고 가정합니다. 다른 이름의 빌드를 사용하는 경우 Chrome이 정상적으로 종료되지 않아 파일 쓰기 권한 오류가 발생할 수 있습니다.

  • 데이터 백업: 스크립트가 Chrome 프로필 데이터를 직접 수정하므로, 만약의 사태를 대비해 User Data 폴더를 백업하는 것이 좋습니다.

  • 권한: Chrome 프로필 소유자와 동일한 OS 사용자 권한으로 스크립트를 실행해야 합니다.

라이선스

Enable Chrome AI 프로젝트는 MIT License로 배포되고 있습니다.

:github: Enable Chrome AI 프로젝트 GitHub 저장소



이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다. :hugs:

:pytorch:파이토치 한국 사용자 모임:south_korea:이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일:love_letter:로 보내드립니다! (기본은 Weekly지만 Daily로 변경도 가능합니다.)

:wrapped_gift: 아래:down_right_arrow:쪽에 좋아요:+1:를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~ :star_struck: