FormBhar is an enterprise-grade, privacy-first Chrome Extension that automates the tedious chore of filling out Google Forms. Armed with advanced AI models (OpenAI GPT-4o-mini, Gemini 1.5 Pro, and Anthropic Claude 3), it reads form structures, understands multiple-choice parameters, and injects logical answers in seconds.
Whether it’s university quizzes, corporate feedback sessions, daily standups, or exam preparation, FormBhar takes care of the entry work with modern automated precision.
- 🤖 🚀 Autonomous Auto-Fill Mode (v2.2): Toggled directly inside settings to automatically fill forms immediately upon loading. Zero clicks required—simply review and click Submit! Fully supports smart automatic fallback to local profile details if no API keys are active.
- 🤖 ✨ Multi-Model AI Engine: Instantly connect your personal API keys for OpenAI, Gemini, or Claude. Includes smart automatic provider fallback if your primary key runs out of quota.
- 🔄 Smart Multi-Page Auto-Filler: Click "Auto-Fill" once on Page 1. The extension securely saves your transient session and automatically fills subsequent pages in the background as you click "Next"!
- 🧠 Coherent Contextual Reasoning: FormBhar doesn't just answer questions in isolation. It uses an advanced contextual prompting structure to link sequential answers together (e.g. justifying "Why?" based on your previous multiple-choice answer).
- 👥 ⚡ 1-Click Profile Autofill: Securely store recurring profile information (Name, Roll No, PRN, Email, etc.) and inject them locally in a single click with zero AI token usage.
- 📋 Paste Answers (No Quota Mode): No API keys? No problem. Use our ChatGPT manual helper to extract questions, copy them formatted, and cleanly map the answers back into the DOM using rigid Regex option parsing.
- 📊 Live Global Telemetry: The popup dashboard connects with a production Node.js/PostgreSQL backend (
https://formbhar-backend-7ir1.onrender.com) to show the total user base and live active sessions in real-time. - 🔒 Privacy-First Design: Sensitive API keys are strictly confined to the isolated, secure Chrome Service Worker environment and never exposed to the page context.
- Clone the repository:
git clone https://github.com/NotArsal/FormBhar.git
- Open Google Chrome and navigate to
chrome://extensions/. - Turn on Developer mode using the toggle switch in the top right.
- Click the Load unpacked button in the top left.
⚠️ CRITICAL: Select theextension/sub-directory inside the cloned repository folder (do not select the root project folder).
- Click the FormBhar puzzle piece icon in your Chrome toolbar.
- Choose your primary AI Provider and input your key:
- OpenAI: Get it at OpenAI Developer Platform
- Gemini: Get it at Google AI Studio
- Claude: Get it at Anthropic Console
- Fill out the 👤 My Profile section with your repetitive information.
- Click Save Settings.
Navigate to any active Google Form URL (docs.google.com/forms/*).
- ⚡ Autonomous Auto-Fill Mode (New in v2.2): If enabled in your settings, you do not need to click any buttons! FormBhar will automatically detect form elements on load, elect the best generator stream (AI or Profile data fallback), and fill the form instantly in the background. Just review and submit!
- Manual Floating Controls: If Autonomous Mode is disabled, three beautiful glassmorphic action buttons float in the bottom-right corner:
- ✨ Auto-Fill with AI: The AI reads the page, generates secure JSON-mapped responses, and dynamically populates the fields. If it's a multi-page form, simply click Next and watch the extension auto-fill page 2 instantly!
- 👤 Fill Profile Data: Instantly injects your saved name, email, roll number, department, and semester.
- 💬 Use ChatGPT (No Quota): Copies a structured prompt to your clipboard and opens ChatGPT in a new tab. Paste the prompt, copy ChatGPT's option replies (e.g.
1. A,2. B), then click the emerging 📋 Paste Answers button on your form.
The backend tracks active user sessions and telemetry:
- Host Platform: Render (Production URL:
https://formbhar-backend-7ir1.onrender.com) - Database: Supabase Managed PostgreSQL
- Architecture: Node.js/Express, utilizing a background alarm mechanism to handle Chromium Service Worker wakeups securely in compliance with Manifest V3 parameters.
For detailed system engineering and PostgreSQL table schema, see README_DETAILED.md.
FormBhar uses automated quality gates to ensure code reliability:
- Linting: ESLint flat config in the backend enforces style rules.
- Testing: Backend contains a test suite run with Jest and Supertest for endpoint validation.
- Continuous Integration: GitHub Actions runs linter checks and unit tests on every pull request and push to
main.
In the backend/ directory:
- Run tests:
npm test - Run linter:
npm run lint - Run development server:
npm run dev
Key architectural decisions are documented in the docs/decisions/ directory:
- ADR-004: Simplify Observability Stack — Replaced OpenTelemetry and Pino with lightweight, high-performance structured JSON console logging.
- ADR-002: CI/CD Pipeline and Trunk-Based Development — Specifying GitHub Actions quality gates and enforcing short-lived branches.
See CHANGELOG.md for recent feature additions and deprecations.