HanaokaYuzu/Gemini-API

✨ Reverse-engineered Python API for Google Gemini web app

What it solves

Google Gemini 웹 앱(구 Bard)과 프로그래밍 방식으로 상호 작용할 수 있는 방법을 제공합니다. 역공학된 비동기 Python 래퍼를 사용함으로써 공식 API에 의존하지 않고 Gemini의 웹 기반 기능을 활용할 수 있습니다.

How it works

이 라이브러리는 Gemini 웹 인터페이스를 래핑합니다. 인증에는 세션 쿠키(__Secure-1PSID와 __Secure-1PSIDTS)를 사용하고, asyncio를 이용한 비동기 클라이언트로 요청을 보내고 응답을 받습니다. 백그라운드 메커니즘을 통해 쿠키를 자동으로 갱신하여 항상 켜져 있는 서비스에서도 지속적인 세션을 유지합니다.

Who it’s for

이미지/비디오/오디오 생성, 심층 연구, Gemini Gems 등 Gemini 웹 앱 기능을 자신의 애플리케이션이나 스크립트에 통합하고자 하는 Python 개발자를 위한 것입니다.

Highlights

  • Multimodal Capabilities: 이미지 생성 및 편집은 물론, 비디오와 오디오/음악 콘텐츠 생성도 지원합니다.
  • Deep Research: 계획 생성, 상태 폴링, 결과 조회까지 전체 워크플로를 구현합니다.
  • Gemini Gems Support: 맞춤형 시스템 프롬프트(Gems)를 적용, 생성, 업데이트, 삭제할 수 있습니다.
  • Extension Integration: YouTube와 Gmail 같은 Gemini 확장 기능 사용을 지원합니다.
  • Advanced Session Management: 자동 갱신되는 영구 쿠키와 대화를 히스토리에 저장하지 않는 임시 모드를 제공합니다.
  • Developer‑Friendly: CLI 도구, 실시간 응답을 위한 스트리밍 모드, 공식 Google Generative AI API에서 영감을 받은 인터페이스를 포함합니다.