Skip to content

Repository files navigation

React Logo      TypeScript Logo      Vite Logo

Jugal-AI

A fully client-side AI interface built with React, TypeScript, and Vite. Powered by the Google Gemini API with zero backend server dependency.

🌐 View Live App


🔑 How It Works (Client-Side API Key)

This project operates 100% on the client side without any backend server infrastructure.

Whether running the app locally or visiting the live site:

  1. Get a free API key from Google AI Studio.
  2. Enter your Gemini API Key directly in the app interface.
  3. The key is stored locally in your browser (localStorage) and is never transmitted to any external backend server.

🛠️ Tech Stack & Dependencies

  • Frontend Framework: React with TypeScript
  • Build Tool: Vite
  • AI Engine: Google Gemini API (@google/genai)
  • Storage: Browser localStorage for client-side API key persistence
  • Styling & UI: Custom React components and stylesheets

📁 Project Structure

.
├── components/      # UI components (chat interface, API key modal, input)
├── services/        # Gemini API service wrapper
├── App.tsx          # Main application setup and state management
├── constants.ts      # Configurations and system prompts
├── index.html       # HTML entry point
├── index.tsx        # React root bootstrap
├── types.ts         # TypeScript interface definitions
├── vite.config.ts   # Vite bundler configuration
└── package.json     # Project dependencies and npm scripts

About

A client-side AI chat application built with React, TypeScript, and Vite. Utilizes Google's Gemini API via a bring-your-own-key approach, running entirely in the browser without a backend server.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages