gemconnect 1.2.0__tar.gz

gemconnect-1.2.0/GemConnect/gemconnect/__init__.py

@@ -0,0 +1,9 @@
+from .connector import ask_gemini
+__version__ = "1.0.0"
+
+def list_models(client):
+    print("The available Gemini Models are:")
+    for model in client.models.list():
+        print(model.name)
+
+    

gemconnect-1.2.0/GemConnect/gemconnect/connector.py

@@ -0,0 +1,39 @@
+# connector.py
+
+from .errors import error_simplify    # imports your errors file
+def ask_gemini(prompt, client, model):
+
+    # Check 1 — empty prompt
+
+    if prompt is None:
+        return "Your prompt is None. Please pass a text string like ask_gemini('hello', client, model)."
+    
+    if prompt.strip() == "":
+        return "Your prompt is empty. Please type something before sending."
+
+    # Check 2 — non-string prompt
+    if not isinstance(prompt, str):
+        return "Your prompt must be plain text. You passed a " + type(prompt).__name__ + " instead of a string."
+
+    # Check 3 — client looks wrong
+
+    if isinstance(client, str):
+        return "You passed a string as the client. You need to create a proper Gemini client first using genai.Client(api_key=...)."
+
+    if client is None:
+        return "Your Gemini client is None. Make sure you created it using genai.Client(api_key=...) before calling ask_gemini()."
+    if model is None:
+        return "You forgot to pass a model name. Try ask_gemini(prompt, client, 'gemini-2.0-flash')."
+
+    if not isinstance(model, str):
+        return "Your model name must be a string like 'gemini-2.0-flash'. You passed a " + type(model).__name__ + " instead."
+
+    if model.strip() == "":
+        return "Your model name is empty. Try ask_gemini(prompt, client, 'gemini-2.0-flash')."
+
+    # rest of your existing code...
+    try:
+        response = client.models.generate_content(model=model, contents=prompt)
+        return response.text
+    except Exception as e:
+        return error_simplify(str(e))

gemconnect-1.2.0/GemConnect/gemconnect/errors.py

@@ -0,0 +1,188 @@
+'''
+scary errors=> string
+
+if you find anyof the key from the dict in the string.
+then return the values.
+
+we use dictory to store the key and value pair.
+'''
+keyword = {
+
+    ### Package setup
+    'FutureWarning':
+        "Your Gemini package is old. Open your terminal and run: pip install --upgrade google-generativeai",
+
+    ### Flask setup
+    'ERR_CONNECTION_REFUSED':
+        "Your Flask server is not running. Go to your terminal and run your app.py file first, then try again.",
+
+    'TemplateNotFound':
+        "Flask cannot find your HTML file. Make sure your HTML file is inside a folder named exactly 'templates' (no capital letters, no spaces).",
+
+    'jinja2':
+        "There is a mistake inside your HTML file. Open index.html and look for any {{ }} or {% %} blocks — one of them has a typo.",
+
+    ### API Key
+    'invalid api key':
+        "Your API key is wrong. Go to aistudio.google.com/apikey, copy your key again and paste it carefully — even one wrong character breaks it.",
+
+    'API key not found':
+        "You forgot to add your API key. Go to aistudio.google.com/apikey, copy your key and paste it where the client is set up in your code.",
+
+    '401 Unauthorized':
+        "Gemini does not recognize you. Your API key is either wrong, expired, or missing. Go to aistudio.google.com/apikey and get a fresh one.",
+
+    ### Quota and model
+     'limit: 0':
+        "This Gemini model has no free quota left. Run list_models() to see other models or go to ai.dev/rate-limit to find one with free quota.",
+
+    'RESOURCE_EXHAUSTED':
+        "You have used up all your free Gemini quota. Go to aistudio.google.com/apikey, create a brand new project and generate a new API key from there.",
+
+    '429 Too Many Requests':
+        "You sent too many requests too fast. Wait 30-60 seconds and try again.",
+
+    '403 Forbidden':
+        "Your account does not have permission to use this model. Try a different model like 'gemini-2.0-flash' which is free for everyone.",
+
+    '404 models':
+        "The model name you typed does not exist. Run list_models() to see the exact names and copy-paste one of those.",
+
+    ### Gemini server errors
+    'InternalServerError':
+        "Something crashed on Gemini's side — this is not your fault. Wait a minute and try the exact same request again.",
+
+    '502':
+        "Gemini's servers are not communicating right now. Wait 2-3 minutes and try again.",
+
+    '503 UNAVAILABLE':
+        "Too many people are using Gemini right now. Wait a few minutes and try again.",
+
+    '504 Timeout':
+        "Gemini took too long to reply. Wait a moment and try again.",
+
+    ### Request errors
+    'PayloadTooLarge':
+        "Your prompt is too long. Try splitting it into smaller pieces and sending one part at a time.",
+
+    'DeadlineExceeded':
+        "Your request took too long. Check your internet connection and try again.",
+
+    'UnprocessableEntity':
+        "Gemini did not understand how your request was structured. Make sure you are passing the prompt as a plain string and not inside a list or dict.",
+
+    ### Safety
+    'safety filters':
+        "Gemini blocked your prompt because it triggered its safety rules. Try rewriting your question in a more neutral way.",
+
+    ### Frontend
+    'blocked by CORS policy':
+        "Your browser is blocking the request because your frontend and backend are on different ports. Install flask-cors and add CORS(app) to your Flask file.",
+
+    'SyntaxError: Unexpected token':
+        "Your Flask server crashed and sent back an error page instead of data. Check your terminal — the real error is printed there.",
+
+    '400 Bad Request':
+        "The data you sent does not match what Flask expected. Make sure the key name in your JavaScript fetch matches exactly what you use in request.json in Flask.",
+    
+    'invalid api key':
+         "Your API key is wrong. Go to aistudio.google.com/apikey, copy your key again and paste it carefully — even one wrong character breaks it.",
+
+    ### Install errors
+    'ModuleNotFoundError':
+        "A required package is not installed. Open your terminal and run: pip install google-generativeai",
+
+    'No module named':
+        "A required package is not installed. Open your terminal and run: pip install google-generativeai",
+
+    ### Network errors
+    'ConnectionError':
+        "Could not reach Gemini. Check your internet connection and try again.",
+
+    'SSLError':
+        "A secure connection to Gemini failed. Check your internet or try a different network.",
+
+    'NewConnectionError':
+        "No internet connection found. Make sure you are connected to the internet and try again.",
+}
+
+
+synonyms = {
+    # Quota
+    'quota':               'RESOURCE_EXHAUSTED',
+    'exhausted':           'RESOURCE_EXHAUSTED',
+    'resource exhausted':  'RESOURCE_EXHAUSTED',
+
+    # Rate limit
+    'rate limit':          '429 Too Many Requests',
+    'too many':            '429 Too Many Requests',
+
+    # Permission
+    'permission denied':   '403 Forbidden',
+    'PERMISSIO DENIED':    '403 Forbidden',
+    'access denied':       '403 Forbidden',
+    'forbidden':           '403 Forbidden',
+
+    # Model
+    'model not found':     '404 models',
+    'not_found':           '404 models',
+
+    # Timeout
+    'timeout':             '504 Timeout',
+    'timed out':           '504 Timeout',
+    'deadline':            'DeadlineExceeded',
+
+    # Payload
+    'payload too large':   'PayloadTooLarge',
+    'prompt too long':     'PayloadTooLarge',
+
+    # Frontend
+    'cors':                'blocked by CORS policy',
+    'cross-origin':        'blocked by CORS policy',
+
+    # Template
+    'template':            'TemplateNotFound',
+
+    # Safety
+    'safety':              'safety filters',
+    'blocked':             'safety filters',
+
+    # Auth
+    'invalid key':         'invalid api key',
+    'API_KEY_INVALID':     'invalid api key',  
+    'API key not valid':   'invalid api key',
+    'unauthorized':        '401 Unauthorized',
+
+    # Request
+    'bad request':         '400 Bad Request',
+
+    # Server
+    'server error':        'InternalServerError',
+    'internal error':      'InternalServerError',
+    'bad gateway':         '502',
+    'service unavailable': '503 UNAVAILABLE',
+
+    # Connection
+    'connection refused':  'ERR_CONNECTION_REFUSED',
+
+    # Package
+    'deprecated':          'FutureWarning',
+    'outdated':            'FutureWarning',
+}
+
+
+def error_simplify(s):
+    s_lower = s.lower()
+
+    # Layer 1 — direct keyword match
+    for k in keyword:
+        if k.lower() in s_lower:
+            return f"**{keyword[k]}**\n\nRaw technical error:\n{s}"
+
+    # Layer 2 — synonym match
+    for alias in synonyms:
+       if alias.lower() in s_lower:    # ← add .lower() here
+            mapped_key = synonyms[alias]
+            return f"**{keyword[mapped_key]}**\n\nRaw technical error:\n{s}"
+    # Nothing matched
+    return f"**GemConnect could not simplify this error.**\n\nHere is the raw error for you to search online:\n{s}"

gemconnect-1.2.0/GemConnect/gemconnect.egg-info/PKG-INFO

@@ -0,0 +1,306 @@
+Metadata-Version: 2.4
+Name: gemconnect
+Version: 1.2.0
+Summary: gemconnect sits between Flask and Gemini, calls the API safely, and if anything goes wrong translates the scary technical error into a simple message the beginner can understand and fix.
+Author-email: Divya P <divyaprofessional416@email.com>
+Project-URL: Homepage, https://github.com/DIVICODER/gemconnect-lib-
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# GemConnect
+
+**GemConnect sits between Flask and Gemini, calls the API safely, and if anything goes wrong, translates the scary technical error into a simple message the beginner can understand and fix.**
+
+---
+
+## The Problem
+
+As an engineer, it felt fascinating to connect upcoming trends like AI into a website and see it work. Getting Gemini to respond in the terminal felt exciting. But when I tried to connect it with the frontend, it once again felt like zero.
+
+Errors kept coming when interconnecting the frontend with Flask. Initially I tried to debug on my own, but it reached a threshold where I shifted from being curious and excited to a mood of just finishing what I had started. I kept copy-pasting the error to an AI bot to debug. Sometimes it worked, sometimes it didn't. But whether it worked or not, I hadn't been able to debug the error myself.
+
+The errors were in technical terms like "404" — like these types of numbers. And in some cases it would show a scary list of errors and say "JSON error" like that, making it difficult to understand what went wrong and where.
+
+What I needed was an error document to understand each error. That problem led to the creation of this library.
+
+---
+
+## What GemConnect Does
+
+GemConnect gets the scary error and converts it into a human-understandable message for easy debugging.
+
+```
+WITHOUT GemConnect:
+Flask → Gemini → 😵 Scary JSON error dump → Beginner gives up
+
+WITH GemConnect:
+Flask → GemConnect → Gemini → ❌ Error?
+                                    ↓
+                        "Hey! Your API key looks wrong.
+                         Go to aistudio.google.com/apikey and get a fresh one."
+```
+
+---
+
+## Who Is This For
+
+Beginners who are really interested in frontend connectivity with AI services but get scared seeing those errors and not knowing how to solve them.
+
+---
+
+## Requirements
+
+Before using GemConnect, install the Gemini package:
+
+```
+pip install google-genai
+```
+
+GemConnect itself has zero dependencies. You are responsible for creating and passing the Gemini client.
+
+---
+
+## Installation
+
+```
+pip install gemconnect
+```
+
+---
+
+## How To Use
+
+```python
+from google import genai
+from gemconnect import ask_gemini
+
+# you bring your own client
+client = genai.Client(api_key="YOUR_API_KEY")
+
+# one line to call Gemini safely
+result = ask_gemini("What is Python?", client, "gemini-2.5-flash")
+print(result)
+```
+
+---
+
+## Input Validation
+
+GemConnect checks your inputs before even calling Gemini. If something is wrong it tells you immediately in plain English:
+
+```python
+ask_gemini(None, client, model)
+# → "Your prompt is None. Please pass a text string like ask_gemini('hello', client, model)."
+
+ask_gemini("", client, model)
+# → "Your prompt is empty. Please type something before sending."
+
+ask_gemini(["hello"], client, model)
+# → "Your prompt must be plain text. You passed a list instead of a string."
+
+ask_gemini(prompt, None, model)
+# → "Your Gemini client is None. Make sure you created it using genai.Client(api_key=...)."
+
+ask_gemini(prompt, client, None)
+# → "You forgot to pass a model name. Try ask_gemini(prompt, client, 'gemini-2.0-flash')."
+
+ask_gemini(prompt, client, "")
+# → "Your model name is empty. Try ask_gemini(prompt, client, 'gemini-2.0-flash')."
+```
+
+---
+
+## How It Works Inside
+
+```
+User writes ask_gemini()
+        ↓
+connector.py runs input checks
+        ↓
+        ┌─────────────────────────┐
+        │                         │
+  checks pass               checks fail
+        │                         │
+        ↓                         ↓
+  calls Gemini API        friendly message
+        │                  returned to user
+        ↓
+  ┌─────────────┐
+  │             │
+SUCCESS       ERROR
+  │             │
+  ↓             ↓
+response.text  errors.py
+  │             │
+  ↓             ↓ Layer 1 — keyword match
+returned      errors.py
+to user        │
+               ↓ Layer 2 — synonym match
+               │
+               ↓
+         simple message
+         returned to user
+```
+
+---
+
+## Real Project Example — Chatbot
+
+```python
+# BEFORE GemConnect — scary errors possible
+response = client.models.generate_content(
+    model="gemini-2.5-flash",
+    contents=conversation
+)
+ai_reply = response.text
+
+
+# AFTER GemConnect — one line, errors handled
+from gemconnect import ask_gemini
+
+ai_reply = ask_gemini(conversation, client, "gemini-2.5-flash")
+```
+
+---
+
+## What Errors GemConnect Covers
+
+Every error message inside GemConnect was collected from real beginner projects. Two layers of matching make sure as many errors as possible are caught.
+
+### Setup Errors
+```
+❌ jinja2.exceptions.TemplateNotFound
+✅ Flask cannot find your HTML file. Make sure your HTML file is inside 
+   a folder named exactly 'templates' (no capital letters, no spaces).
+
+❌ ERR_CONNECTION_REFUSED
+✅ Your Flask server is not running. Go to your terminal and run your 
+   app.py file first, then try again.
+
+❌ FutureWarning: google.generativeai has ended
+✅ Your Gemini package is old. Open your terminal and run: 
+   pip install --upgrade google-generativeai
+```
+
+### Install Errors
+```
+❌ ModuleNotFoundError: No module named 'google.generativeai'
+✅ A required package is not installed. Open your terminal and run: 
+   pip install google-generativeai
+```
+
+### API Key Errors
+```
+❌ 401 Unauthorized
+✅ Gemini does not recognize you. Your API key is either wrong, expired, 
+   or missing. Go to aistudio.google.com/apikey and get a fresh one.
+
+❌ API key not valid. Please pass a valid API key.
+✅ Your API key is wrong. Go to aistudio.google.com/apikey, copy your 
+   key again and paste it carefully — even one wrong character breaks it.
+```
+
+### Quota Errors
+```
+❌ RESOURCE_EXHAUSTED
+✅ You have used up all your free Gemini quota. Go to 
+   aistudio.google.com/apikey, create a brand new project and generate 
+   a new API key from there.
+
+❌ 429 Too Many Requests
+✅ You sent too many requests too fast. Wait 30-60 seconds and try again.
+```
+
+### Model Errors
+```
+❌ 404 models/gemini-1.5-flash is not found
+✅ The model name you typed does not exist. Run list_models() to see the 
+   exact names and copy-paste one of those.
+```
+
+### Gemini Server Errors
+```
+❌ InternalServerError
+✅ Something crashed on Gemini's side — this is not your fault. 
+   Wait a minute and try the exact same request again.
+
+❌ 503 UNAVAILABLE
+✅ Too many people are using Gemini right now. Wait a few minutes and try again.
+
+❌ 504 Timeout
+✅ Gemini took too long to reply. Wait a moment and try again.
+```
+
+### Network Errors
+```
+❌ ConnectionError
+✅ Could not reach Gemini. Check your internet connection and try again.
+
+❌ SSLError
+✅ A secure connection to Gemini failed. Check your internet or try a 
+   different network.
+```
+
+### Frontend Errors
+```
+❌ blocked by CORS policy
+✅ Your browser is blocking the request because your frontend and backend 
+   are on different ports. Install flask-cors and add CORS(app) to your Flask file.
+
+❌ SyntaxError: Unexpected token
+✅ Your Flask server crashed and sent back an error page instead of data. 
+   Check your terminal — the real error is printed there.
+```
+
+---
+
+## Check Available Models
+
+Not sure which model to use? Run this:
+
+```python
+from google import genai
+from gemconnect import list_models
+
+client = genai.Client(api_key="YOUR_API_KEY")
+list_models(client)
+```
+
+This prints all models your API key can access.
+
+---
+
+## What GemConnect Supports — v1.0
+
+```
+Works with:
+✅ PDF Summarizer      (extract text first, pass as string)
+✅ Chatbot             (conversation as plain string)
+✅ Text Summarizer     (plain text input)
+✅ CSV Analyzer        (convert to string with df.to_string())
+✅ Any project where input to Gemini is plain text
+
+Coming in v2.0:
+🔜 Image support
+🔜 Audio support
+🔜 Video support
+```
+
+---
+
+## Check Version
+
+```python
+import gemconnect
+print(gemconnect.__version__)
+```
+
+---
+
+## Built From Real Mistakes
+
+This library was not built from assumptions. Every error message inside GemConnect was collected from real beginner projects — PDF summarizer, chatbot, image describer, audio transcriber. Each scary error was faced, documented, and translated into a simple message.
+
+**GemConnect v1.0 — Built from real beginner mistakes, for real beginners.**

gemconnect-1.2.0/GemConnect/gemconnect.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+GemConnect/gemconnect/__init__.py
+GemConnect/gemconnect/connector.py
+GemConnect/gemconnect/errors.py
+GemConnect/gemconnect.egg-info/PKG-INFO
+GemConnect/gemconnect.egg-info/SOURCES.txt
+GemConnect/gemconnect.egg-info/dependency_links.txt
+GemConnect/gemconnect.egg-info/top_level.txt

gemconnect-1.2.0/GemConnect/gemconnect.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

gemconnect-1.2.0/GemConnect/gemconnect.egg-info/top_level.txt

@@ -0,0 +1 @@
+gemconnect

gemconnect-1.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DIVYA 
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

gemconnect-1.2.0/PKG-INFO

@@ -0,0 +1,306 @@
+Metadata-Version: 2.4
+Name: gemconnect
+Version: 1.2.0
+Summary: gemconnect sits between Flask and Gemini, calls the API safely, and if anything goes wrong translates the scary technical error into a simple message the beginner can understand and fix.
+Author-email: Divya P <divyaprofessional416@email.com>
+Project-URL: Homepage, https://github.com/DIVICODER/gemconnect-lib-
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# GemConnect
+
+**GemConnect sits between Flask and Gemini, calls the API safely, and if anything goes wrong, translates the scary technical error into a simple message the beginner can understand and fix.**
+
+---
+
+## The Problem
+
+As an engineer, it felt fascinating to connect upcoming trends like AI into a website and see it work. Getting Gemini to respond in the terminal felt exciting. But when I tried to connect it with the frontend, it once again felt like zero.
+
+Errors kept coming when interconnecting the frontend with Flask. Initially I tried to debug on my own, but it reached a threshold where I shifted from being curious and excited to a mood of just finishing what I had started. I kept copy-pasting the error to an AI bot to debug. Sometimes it worked, sometimes it didn't. But whether it worked or not, I hadn't been able to debug the error myself.
+
+The errors were in technical terms like "404" — like these types of numbers. And in some cases it would show a scary list of errors and say "JSON error" like that, making it difficult to understand what went wrong and where.
+
+What I needed was an error document to understand each error. That problem led to the creation of this library.
+
+---
+
+## What GemConnect Does
+
+GemConnect gets the scary error and converts it into a human-understandable message for easy debugging.
+
+```
+WITHOUT GemConnect:
+Flask → Gemini → 😵 Scary JSON error dump → Beginner gives up
+
+WITH GemConnect:
+Flask → GemConnect → Gemini → ❌ Error?
+                                    ↓
+                        "Hey! Your API key looks wrong.
+                         Go to aistudio.google.com/apikey and get a fresh one."
+```
+
+---
+
+## Who Is This For
+
+Beginners who are really interested in frontend connectivity with AI services but get scared seeing those errors and not knowing how to solve them.
+
+---
+
+## Requirements
+
+Before using GemConnect, install the Gemini package:
+
+```
+pip install google-genai
+```
+
+GemConnect itself has zero dependencies. You are responsible for creating and passing the Gemini client.
+
+---
+
+## Installation
+
+```
+pip install gemconnect
+```
+
+---
+
+## How To Use
+
+```python
+from google import genai
+from gemconnect import ask_gemini
+
+# you bring your own client
+client = genai.Client(api_key="YOUR_API_KEY")
+
+# one line to call Gemini safely
+result = ask_gemini("What is Python?", client, "gemini-2.5-flash")
+print(result)
+```
+
+---
+
+## Input Validation
+
+GemConnect checks your inputs before even calling Gemini. If something is wrong it tells you immediately in plain English:
+
+```python
+ask_gemini(None, client, model)
+# → "Your prompt is None. Please pass a text string like ask_gemini('hello', client, model)."
+
+ask_gemini("", client, model)
+# → "Your prompt is empty. Please type something before sending."
+
+ask_gemini(["hello"], client, model)
+# → "Your prompt must be plain text. You passed a list instead of a string."
+
+ask_gemini(prompt, None, model)
+# → "Your Gemini client is None. Make sure you created it using genai.Client(api_key=...)."
+
+ask_gemini(prompt, client, None)
+# → "You forgot to pass a model name. Try ask_gemini(prompt, client, 'gemini-2.0-flash')."
+
+ask_gemini(prompt, client, "")
+# → "Your model name is empty. Try ask_gemini(prompt, client, 'gemini-2.0-flash')."
+```
+
+---
+
+## How It Works Inside
+
+```
+User writes ask_gemini()
+        ↓
+connector.py runs input checks
+        ↓
+        ┌─────────────────────────┐
+        │                         │
+  checks pass               checks fail
+        │                         │
+        ↓                         ↓
+  calls Gemini API        friendly message
+        │                  returned to user
+        ↓
+  ┌─────────────┐
+  │             │
+SUCCESS       ERROR
+  │             │
+  ↓             ↓
+response.text  errors.py
+  │             │
+  ↓             ↓ Layer 1 — keyword match
+returned      errors.py
+to user        │
+               ↓ Layer 2 — synonym match
+               │
+               ↓
+         simple message
+         returned to user
+```
+
+---
+
+## Real Project Example — Chatbot
+
+```python
+# BEFORE GemConnect — scary errors possible
+response = client.models.generate_content(
+    model="gemini-2.5-flash",
+    contents=conversation
+)
+ai_reply = response.text
+
+
+# AFTER GemConnect — one line, errors handled
+from gemconnect import ask_gemini
+
+ai_reply = ask_gemini(conversation, client, "gemini-2.5-flash")
+```
+
+---
+
+## What Errors GemConnect Covers
+
+Every error message inside GemConnect was collected from real beginner projects. Two layers of matching make sure as many errors as possible are caught.
+
+### Setup Errors
+```
+❌ jinja2.exceptions.TemplateNotFound
+✅ Flask cannot find your HTML file. Make sure your HTML file is inside 
+   a folder named exactly 'templates' (no capital letters, no spaces).
+
+❌ ERR_CONNECTION_REFUSED
+✅ Your Flask server is not running. Go to your terminal and run your 
+   app.py file first, then try again.
+
+❌ FutureWarning: google.generativeai has ended
+✅ Your Gemini package is old. Open your terminal and run: 
+   pip install --upgrade google-generativeai
+```
+
+### Install Errors
+```
+❌ ModuleNotFoundError: No module named 'google.generativeai'
+✅ A required package is not installed. Open your terminal and run: 
+   pip install google-generativeai
+```
+
+### API Key Errors
+```
+❌ 401 Unauthorized
+✅ Gemini does not recognize you. Your API key is either wrong, expired, 
+   or missing. Go to aistudio.google.com/apikey and get a fresh one.
+
+❌ API key not valid. Please pass a valid API key.
+✅ Your API key is wrong. Go to aistudio.google.com/apikey, copy your 
+   key again and paste it carefully — even one wrong character breaks it.
+```
+
+### Quota Errors
+```
+❌ RESOURCE_EXHAUSTED
+✅ You have used up all your free Gemini quota. Go to 
+   aistudio.google.com/apikey, create a brand new project and generate 
+   a new API key from there.
+
+❌ 429 Too Many Requests
+✅ You sent too many requests too fast. Wait 30-60 seconds and try again.
+```
+
+### Model Errors
+```
+❌ 404 models/gemini-1.5-flash is not found
+✅ The model name you typed does not exist. Run list_models() to see the 
+   exact names and copy-paste one of those.
+```
+
+### Gemini Server Errors
+```
+❌ InternalServerError
+✅ Something crashed on Gemini's side — this is not your fault. 
+   Wait a minute and try the exact same request again.
+
+❌ 503 UNAVAILABLE
+✅ Too many people are using Gemini right now. Wait a few minutes and try again.
+
+❌ 504 Timeout
+✅ Gemini took too long to reply. Wait a moment and try again.
+```
+
+### Network Errors
+```
+❌ ConnectionError
+✅ Could not reach Gemini. Check your internet connection and try again.
+
+❌ SSLError
+✅ A secure connection to Gemini failed. Check your internet or try a 
+   different network.
+```
+
+### Frontend Errors
+```
+❌ blocked by CORS policy
+✅ Your browser is blocking the request because your frontend and backend 
+   are on different ports. Install flask-cors and add CORS(app) to your Flask file.
+
+❌ SyntaxError: Unexpected token
+✅ Your Flask server crashed and sent back an error page instead of data. 
+   Check your terminal — the real error is printed there.
+```
+
+---
+
+## Check Available Models
+
+Not sure which model to use? Run this:
+
+```python
+from google import genai
+from gemconnect import list_models
+
+client = genai.Client(api_key="YOUR_API_KEY")
+list_models(client)
+```
+
+This prints all models your API key can access.
+
+---
+
+## What GemConnect Supports — v1.0
+
+```
+Works with:
+✅ PDF Summarizer      (extract text first, pass as string)
+✅ Chatbot             (conversation as plain string)
+✅ Text Summarizer     (plain text input)
+✅ CSV Analyzer        (convert to string with df.to_string())
+✅ Any project where input to Gemini is plain text
+
+Coming in v2.0:
+🔜 Image support
+🔜 Audio support
+🔜 Video support
+```
+
+---
+
+## Check Version
+
+```python
+import gemconnect
+print(gemconnect.__version__)
+```
+
+---
+
+## Built From Real Mistakes
+
+This library was not built from assumptions. Every error message inside GemConnect was collected from real beginner projects — PDF summarizer, chatbot, image describer, audio transcriber. Each scary error was faced, documented, and translated into a simple message.
+
+**GemConnect v1.0 — Built from real beginner mistakes, for real beginners.**

gemconnect-1.2.0/README.md

@@ -0,0 +1,295 @@
+# GemConnect
+
+**GemConnect sits between Flask and Gemini, calls the API safely, and if anything goes wrong, translates the scary technical error into a simple message the beginner can understand and fix.**
+
+---
+
+## The Problem
+
+As an engineer, it felt fascinating to connect upcoming trends like AI into a website and see it work. Getting Gemini to respond in the terminal felt exciting. But when I tried to connect it with the frontend, it once again felt like zero.
+
+Errors kept coming when interconnecting the frontend with Flask. Initially I tried to debug on my own, but it reached a threshold where I shifted from being curious and excited to a mood of just finishing what I had started. I kept copy-pasting the error to an AI bot to debug. Sometimes it worked, sometimes it didn't. But whether it worked or not, I hadn't been able to debug the error myself.
+
+The errors were in technical terms like "404" — like these types of numbers. And in some cases it would show a scary list of errors and say "JSON error" like that, making it difficult to understand what went wrong and where.
+
+What I needed was an error document to understand each error. That problem led to the creation of this library.
+
+---
+
+## What GemConnect Does
+
+GemConnect gets the scary error and converts it into a human-understandable message for easy debugging.
+
+```
+WITHOUT GemConnect:
+Flask → Gemini → 😵 Scary JSON error dump → Beginner gives up
+
+WITH GemConnect:
+Flask → GemConnect → Gemini → ❌ Error?
+                                    ↓
+                        "Hey! Your API key looks wrong.
+                         Go to aistudio.google.com/apikey and get a fresh one."
+```
+
+---
+
+## Who Is This For
+
+Beginners who are really interested in frontend connectivity with AI services but get scared seeing those errors and not knowing how to solve them.
+
+---
+
+## Requirements
+
+Before using GemConnect, install the Gemini package:
+
+```
+pip install google-genai
+```
+
+GemConnect itself has zero dependencies. You are responsible for creating and passing the Gemini client.
+
+---
+
+## Installation
+
+```
+pip install gemconnect
+```
+
+---
+
+## How To Use
+
+```python
+from google import genai
+from gemconnect import ask_gemini
+
+# you bring your own client
+client = genai.Client(api_key="YOUR_API_KEY")
+
+# one line to call Gemini safely
+result = ask_gemini("What is Python?", client, "gemini-2.5-flash")
+print(result)
+```
+
+---
+
+## Input Validation
+
+GemConnect checks your inputs before even calling Gemini. If something is wrong it tells you immediately in plain English:
+
+```python
+ask_gemini(None, client, model)
+# → "Your prompt is None. Please pass a text string like ask_gemini('hello', client, model)."
+
+ask_gemini("", client, model)
+# → "Your prompt is empty. Please type something before sending."
+
+ask_gemini(["hello"], client, model)
+# → "Your prompt must be plain text. You passed a list instead of a string."
+
+ask_gemini(prompt, None, model)
+# → "Your Gemini client is None. Make sure you created it using genai.Client(api_key=...)."
+
+ask_gemini(prompt, client, None)
+# → "You forgot to pass a model name. Try ask_gemini(prompt, client, 'gemini-2.0-flash')."
+
+ask_gemini(prompt, client, "")
+# → "Your model name is empty. Try ask_gemini(prompt, client, 'gemini-2.0-flash')."
+```
+
+---
+
+## How It Works Inside
+
+```
+User writes ask_gemini()
+        ↓
+connector.py runs input checks
+        ↓
+        ┌─────────────────────────┐
+        │                         │
+  checks pass               checks fail
+        │                         │
+        ↓                         ↓
+  calls Gemini API        friendly message
+        │                  returned to user
+        ↓
+  ┌─────────────┐
+  │             │
+SUCCESS       ERROR
+  │             │
+  ↓             ↓
+response.text  errors.py
+  │             │
+  ↓             ↓ Layer 1 — keyword match
+returned      errors.py
+to user        │
+               ↓ Layer 2 — synonym match
+               │
+               ↓
+         simple message
+         returned to user
+```
+
+---
+
+## Real Project Example — Chatbot
+
+```python
+# BEFORE GemConnect — scary errors possible
+response = client.models.generate_content(
+    model="gemini-2.5-flash",
+    contents=conversation
+)
+ai_reply = response.text
+
+
+# AFTER GemConnect — one line, errors handled
+from gemconnect import ask_gemini
+
+ai_reply = ask_gemini(conversation, client, "gemini-2.5-flash")
+```
+
+---
+
+## What Errors GemConnect Covers
+
+Every error message inside GemConnect was collected from real beginner projects. Two layers of matching make sure as many errors as possible are caught.
+
+### Setup Errors
+```
+❌ jinja2.exceptions.TemplateNotFound
+✅ Flask cannot find your HTML file. Make sure your HTML file is inside 
+   a folder named exactly 'templates' (no capital letters, no spaces).
+
+❌ ERR_CONNECTION_REFUSED
+✅ Your Flask server is not running. Go to your terminal and run your 
+   app.py file first, then try again.
+
+❌ FutureWarning: google.generativeai has ended
+✅ Your Gemini package is old. Open your terminal and run: 
+   pip install --upgrade google-generativeai
+```
+
+### Install Errors
+```
+❌ ModuleNotFoundError: No module named 'google.generativeai'
+✅ A required package is not installed. Open your terminal and run: 
+   pip install google-generativeai
+```
+
+### API Key Errors
+```
+❌ 401 Unauthorized
+✅ Gemini does not recognize you. Your API key is either wrong, expired, 
+   or missing. Go to aistudio.google.com/apikey and get a fresh one.
+
+❌ API key not valid. Please pass a valid API key.
+✅ Your API key is wrong. Go to aistudio.google.com/apikey, copy your 
+   key again and paste it carefully — even one wrong character breaks it.
+```
+
+### Quota Errors
+```
+❌ RESOURCE_EXHAUSTED
+✅ You have used up all your free Gemini quota. Go to 
+   aistudio.google.com/apikey, create a brand new project and generate 
+   a new API key from there.
+
+❌ 429 Too Many Requests
+✅ You sent too many requests too fast. Wait 30-60 seconds and try again.
+```
+
+### Model Errors
+```
+❌ 404 models/gemini-1.5-flash is not found
+✅ The model name you typed does not exist. Run list_models() to see the 
+   exact names and copy-paste one of those.
+```
+
+### Gemini Server Errors
+```
+❌ InternalServerError
+✅ Something crashed on Gemini's side — this is not your fault. 
+   Wait a minute and try the exact same request again.
+
+❌ 503 UNAVAILABLE
+✅ Too many people are using Gemini right now. Wait a few minutes and try again.
+
+❌ 504 Timeout
+✅ Gemini took too long to reply. Wait a moment and try again.
+```
+
+### Network Errors
+```
+❌ ConnectionError
+✅ Could not reach Gemini. Check your internet connection and try again.
+
+❌ SSLError
+✅ A secure connection to Gemini failed. Check your internet or try a 
+   different network.
+```
+
+### Frontend Errors
+```
+❌ blocked by CORS policy
+✅ Your browser is blocking the request because your frontend and backend 
+   are on different ports. Install flask-cors and add CORS(app) to your Flask file.
+
+❌ SyntaxError: Unexpected token
+✅ Your Flask server crashed and sent back an error page instead of data. 
+   Check your terminal — the real error is printed there.
+```
+
+---
+
+## Check Available Models
+
+Not sure which model to use? Run this:
+
+```python
+from google import genai
+from gemconnect import list_models
+
+client = genai.Client(api_key="YOUR_API_KEY")
+list_models(client)
+```
+
+This prints all models your API key can access.
+
+---
+
+## What GemConnect Supports — v1.0
+
+```
+Works with:
+✅ PDF Summarizer      (extract text first, pass as string)
+✅ Chatbot             (conversation as plain string)
+✅ Text Summarizer     (plain text input)
+✅ CSV Analyzer        (convert to string with df.to_string())
+✅ Any project where input to Gemini is plain text
+
+Coming in v2.0:
+🔜 Image support
+🔜 Audio support
+🔜 Video support
+```
+
+---
+
+## Check Version
+
+```python
+import gemconnect
+print(gemconnect.__version__)
+```
+
+---
+
+## Built From Real Mistakes
+
+This library was not built from assumptions. Every error message inside GemConnect was collected from real beginner projects — PDF summarizer, chatbot, image describer, audio transcriber. Each scary error was faced, documented, and translated into a simple message.
+
+**GemConnect v1.0 — Built from real beginner mistakes, for real beginners.**

gemconnect-1.2.0/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+
+
+[project]
+name = "gemconnect"
+version = "1.2.0"
+description = "gemconnect sits between Flask and Gemini, calls the API safely, and if anything goes wrong translates the scary technical error into a simple message the beginner can understand and fix."
+readme = "README.md"
+requires-python = ">=3.8"
+dependencies = []
+authors = [
+    {name = "Divya P", email = "divyaprofessional416@email.com"}
+]
+
+[project.urls]
+Homepage = "https://github.com/DIVICODER/gemconnect-lib-"
+
+[tool.setuptools]
+package-dir = {"" = "GemConnect"}
+packages = ["gemconnect"]

gemconnect-1.2.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+