https://github.com/rekcah-pavi/geminikit
The unofficial Python package that returns the response from Google Gemini using a cookie value, using reverse engineering. Demo: https://t.me/bard_kpbot/
https://github.com/rekcah-pavi/geminikit
api bard bard-api gemini gemini-api google-bard google-bard-api google-gemini google-gemini-ai
Last synced: 5 months ago
JSON representation
The unofficial Python package that returns the response from Google Gemini using a cookie value, using reverse engineering. Demo: https://t.me/bard_kpbot/
- Host: GitHub
- URL: https://github.com/rekcah-pavi/geminikit
- Owner: rekcah-pavi
- License: mit
- Created: 2024-07-21T05:42:47.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-10-05T02:58:58.000Z (over 1 year ago)
- Last Synced: 2025-07-28T14:35:23.159Z (11 months ago)
- Topics: api, bard, bard-api, gemini, gemini-api, google-bard, google-bard-api, google-gemini, google-gemini-ai
- Language: Python
- Homepage: https://pypi.org/project/geminikit/
- Size: 2.61 MB
- Stars: 30
- Watchers: 2
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 
GeminiKit
**GeminiKit** is an unofficial Python wrapper developed through reverse-engineering. This tool utilizes cookie values to interact with Google Gemini for testing purposes.
## Installation
To install GeminiKit, you can use pip:
```bash
pip install -U geminikit
```
or
```bash
pip install git+https://github.com/rekcah-pavi/geminikit
```
***
## Get Cookie File (chrome-net-export-log)
For a detailed video guide, [click here](https://youtu.be/IUCJg2KWcJs).
### 1. Close All Tabs
Ensure all tabs are closed in Google Chrome.
### 2. Access Network Export
- Open a new tab and navigate to `chrome://net-export/`.
### 3. Configure Logging Settings
- Check the box labeled `Include cookies and credentials`.
- Set the `Maximum log size` to `1 MB`.
- Click the `Start logging` button.
### 4. Perform Actions
- Open a new tab and go to [gemini.google.com](https://gemini.google.com).
- Log in to your Gemini account.
- Send a sample message and wait for Gemini's response.
### 5. Stop Logging
- Return to the logging tab and click the `Stop logging` button.
### 6. Retrieve Cookies
- The cookies will be saved in a JSON file.
### 7. Extract Cookies from File
```python
from geminikit import get_cookies_from_file
with open("chrome-net-export-log.json", 'r') as f:
cookies = get_cookies_from_file(f.read())
print(cookies)
```
***
## Usage
### Setup Gemini
Sync
```python
from geminikit import get_cookies_from_file
from geminikit import Gemini
with open("chrome-net-export-log.json", 'r') as f:
cookies = get_cookies_from_file(f.read())
gemini = Gemini(cookies)
```
Async
```python
from geminikit import get_cookies_from_file
from geminikit import Asynic_Gemini as Gemini
import asyncio
import aiofiles #pip install aiofiles
async def main():
async with aiofiles.open("chrome-net-export-log.json", mode='r') as f:
cookies = get_cookies_from_file(await f.read())
gemini = await Gemini.create(cookies)
asyncio.run(main())
```
### Ask a Message
Sync
```python
res = gemini.ask("hello")
print(res['text'])
```
Async
```python
res = await gemini.ask("hello")
print(res['text'])
```
### Ask continuous message
Sync
```python
response = gemini.ask("tell me a joke")
print(res['text'])
#user value must be a dictionary containing SNlM0e, conversation_id, response_id, choice_id (available inside the response dictionary)
res = gemini.ask("another one",user=response)
print(res['text'])
```
Async
```python
response = await gemini.ask("tell me a joke")
print(res['text'])
#user value must be a dictionary containing SNlM0e, conversation_id, response_id, choice_id (available inside the response dictionary)
res = await gemini.ask("another one",user=response)
print(res['text'])
```
### Text to Voice
Sync
```python
res = gemini.speech("hello")
#res = gemini.speech("hello", lang_code="en")
with open("a.wav", "wb") as f:
f.write(res)
```
Async
```python
import aiofiles #pip install aiofiles
res = await gemini.speech("hello")
#res = gemini.speech("hello", lang_code="en")
async with aiofiles.open("a.wav", mode='wb') as f:
await f.write(res)
```
### Ask with Photo
Sync
```python
with open("cat.jpg", "rb") as f:
img_link = gemini.upload_image(f.read())
photo = ['cat.jpg', img_link] # photo name (if not available, use 'none.jpg'), link
res = gemini.ask("What is in this photo?", photo=photo)
print(res['text'])
```
Async
```python
import aiofiles #pip install aiofiles
async with aiofiles.open("cat.jpg", mode='rb') as f:
img_data = await f.read()
img_link = await gemini.upload_image(img_data)
photo = ['cat.jpg', img_link] # photo name (if not available, use 'none.jpg'), link
res = await gemini.ask("What is in this photo?", photo=photo)
print(res['text'])
```
### Save Response Images
Sync
```python
res = gemini.ask("send me some wallpapers")
print(res['text'])
#Or You can access URLs directly
for url in res['image_urls']:
img_name = url.split("/")[-1]
img_bytes = gemini.get_img_bytes(url)
with open(img_name, 'wb') as f:
f.write(img_bytes)
```
Async
```python
import aiofiles #pip install aiofiles
res = await gemini.ask("send me some wallpapers")
print(res['text'])
#Or You can access URLs directly
for url in res['image_urls']:
img_name = url.split("/")[-1]
img_bytes = await gemini.get_img_bytes(url)
async with aiofiles.open(img_name, mode='wb') as f:
await f.write(img_bytes)
```
### Save Generated Images
Sync
```python
res = gemini.ask("Generate an image of a cat holding a rose.")
print(res['text'])
for url in res['generated_image_urls']:
img_name = url.split("/")[-1][:10] + ".png"
img_bytes = gemini.get_img_bytes(url)
with open(img_name, 'wb') as f:
f.write(img_bytes)
```
Async
```python
import aiofiles #pip install aiofiles
res = await gemini.ask("Generate an image of a cat holding a rose.")
print(res['text'])
for url in res['generated_image_urls']:
img_name = url.split("/")[-1][:10] + ".png"
img_bytes = await gemini.get_img_bytes(url)
async with aiofiles.open(img_name, mode='wb') as f:
await f.write(img_bytes)
```
### Get Sharable URL
Sync
```python
res = gemini.ask("Hi")
url = gemini.share(res['conversation_id'], res['response_id'], res['choice_id'], res['req_id'], res['fsid'], title="test by me")
print(url)
```
Async
```python
res = await gemini.ask("Hi")
url = await gemini.share(res['conversation_id'], res['response_id'], res['choice_id'], res['req_id'], res['fsid'], title="test by me")
print(url)
```