Skip to content

ddtcorex/omni-ai

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

173 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Omni AI

๐Ÿง  Your All-in-One AI Browser Companion. Supercharge your Chrome experience with the power of Google Gemini, OpenAI, Groq, and Custom Gateway.

Version License Chrome

Omni AI is a modern, lightweight Chrome extension that integrates advanced AI models directly into your workflow. Whether you're drafting emails, debugging code, reading foreign articles, or researching complex topics, Omni AI helps you write better, read faster, and understand everything instantly.


โœจ Features

๐Ÿš€ Smart Selection Actions

Highlight any text on any website to see the โœจ Omni AI Floating Button. One click gives you access to:

  • Fix Grammar & Spelling - Professional polish in a click.
  • Rephrase - Rewrite with different words for better flow.
  • Summarize - Get the gist of long paragraphs instantly.
  • Change Tone - Swiftly switch between Professional, Casual, Formal, and more.
  • Ask AI - Direct chat contextually based on your selection.
  • Persistent Chat - Popup chat retains history for multi-turn conversations.
  • Context Awareness - AI remembers context from previous messages in the popup.
  • Page Context - Smarter answers with awareness of the current page title and URL.

๐Ÿ“‹ Writing Enhancements

Dedicated tools for specific needs:

  • Improve Clarity - Make your thoughts clearer.
  • Make Concise - Cut the fluff.
  • Expand - Elaborate with AI-generated depth.
  • Emojify - Add the perfect emojis for social or chat.

๐Ÿ“ Rich Text & Input Support

  • Universal Compatibility: Works on input, textarea, and rich text editors like TinyMCE.
  • Smart Replacement: "Replace" button seamlessly updates content in complex editors.

๐ŸŒ Instant Translation & Explanation

  • Translate - Supports 10+ languages including Spanish, French, German, Japanese, and Chinese.
  • Primary Language - Set your native language (e.g., Vietnamese) for one-click instant translations.
  • Explain - Simplifies difficult concepts, technical jargon, or complex paragraphs.

๐Ÿ“Š Dashboard & Usage Statistics

Track your productivity with the new Usage Dashboard:

  • Monitor Total Actions taken.
  • See how many Words Processed and Words Generated.
  • Clean, grid-based visualization for your AI activity.

๐Ÿ› ๏ธ Premium Settings UI

  • Multiple AI Providers: Support for Google Gemini (2.0 Flash, 2.5 Flash, 2.5 Flash Lite), OpenAI (GPT-4o, GPT-4o Mini, GPT-4 Turbo), Groq (Llama 3.3, Llama 3.1, GPT-OSS 120B), and Custom Gateway (OpenAI-compatible).
  • Glassmorphic Design: A sleek, modern settings page (settings.html) with smooth animations and high-resolution visuals.
  • Helper Tooltips: Interactive instructions and links to help you get your API keys quickly.
  • Context Presets: Tailor AI responses for Email, Chat, Social Media, Technical, or Academic contexts.

๐Ÿš€ Installation

1. Clone the repository

git clone https://github.com/ddtcorex/omni-ai.git
cd omni-ai

2. Load into Chrome

  1. Open Chrome and navigate to chrome://extensions.
  2. Enable Developer mode (top right toggle).
  3. Click Load unpacked.
  4. Select the omni-ai directory.

๐Ÿ”‘ Configuration

1. AI Provider Configuration (Required)

You can choose between Google Gemini, OpenAI, Groq, or Custom Gateway as your AI provider.

Option A: Google Gemini

  1. Go to Google AI Studio.
  2. Create a new API key.
  3. In Omni AI, go to Settings > AI Model and select a Google Gemini model.
  4. Paste your key and save.

Option B: OpenAI (GPT-4)

  1. Go to OpenAI Platform.
  2. Create a new API Key.
  3. In Omni AI, select an OpenAI model.
  4. Paste your key sk-... and save.

Option C: Groq (Llama 3)

  1. Go to Groq Console.
  2. Create a new API Key.
  3. In Omni AI, select a Groq model.
  4. Paste your key gsk_... and save.

Option D: Custom Gateway

Connect to any OpenAI-compatible API endpoint (OpenRouter, LiteLLM, Together AI, your own proxy, etc.):

  1. In Omni AI, select Custom Gateway from the model dropdown.
  2. Enter your Base URL (e.g., https://openrouter.ai/api/v1, https://your-gateway.com/v1).
  3. Enter your API Key (optional for some gateways).
  4. Enter the Model Name (e.g., anthropic/claude-sonnet-4-20250514).
  5. Click Validate Configuration to test.

2. Custom Model Configuration

Omni AI allows you to use any model provided by your chosen AI provider, even if it's not in the default list.

How to use Custom Models

  1. In Settings, find the AI Model dropdown.
  2. Select the "Custom Model..." option for your preferred provider (e.g., OpenAI Custom Model...).
  3. A new field Custom Model Name will appear.
  4. Enter the Model ID provided by the AI platform (e.g., gpt-4o-2024-08-06 for OpenAI).
  5. Click Save Settings.

๐Ÿง  Intelligent Model ID Resolution

Omni AI features a smart resolution system that maps common short names to their official API IDs. You can enter a simplified name, and the extension will automatically use the correct implementation:

  • Groq: Entering llama-3.1-8b automatically maps to llama-3.1-8b-instant.
  • OpenAI: Entering gpt-4o maps to the latest stable gpt-4o version.

Common Custom Model IDs

  • Groq: llama-3.3-70b-versatile, deepseek-r1-distill-llama-70b, mixtral-8x7b-32768.
  • OpenAI: gpt-4o, gpt-4o-mini, o1-preview.
  • Google: gemini-1.5-pro-latest, gemini-2.0-flash-exp.
  • Custom Gateway: Varies by provider (e.g., OpenRouter: anthropic/claude-sonnet-4-20250514).

3. Google Sign-In (Optional)

To use the personalization features (syncing settings across devices), you need to configure OAuth.

  1. Go to Google Cloud Console.

  2. Create a new project.

  3. Navigate to APIs & Services > Credentials.

  4. Create OAuth client ID > Chrome extension.

  5. Detailed steps can be found in the Chrome Identity API docs.

  6. Copy the client_id and paste it into manifest.json:

    "oauth2": {
      "client_id": "YOUR_NEW_CLIENT_ID.apps.googleusercontent.com",
      ...
    }
  7. (Recommended) Copy the key from the Developer Dashboard to manifest.json to keep the extension ID stable.


โŒจ๏ธ Keyboard Shortcuts

Shortcut Action
Alt+O Open Omni AI Popup
Alt+A Quick Ask Overlay (Ask AI from any page)
Alt+R Rephrase (on selected text)
Alt+T Translate to Primary Language

Shortcuts can be customized in chrome://extensions/shortcuts


๐ŸŒ Multilingual Support

Omni AI currently supports 10 languages:

  • ๐Ÿ‡บ๐Ÿ‡ธ English
  • ๐Ÿ‡ป๐Ÿ‡ณ Vietnamese (Default)
  • ๐Ÿ‡ช๐Ÿ‡ธ Spanish
  • ๐Ÿ‡ซ๐Ÿ‡ท French
  • ๐Ÿ‡ฉ๐Ÿ‡ช German
  • ๐Ÿ‡ฎ๐Ÿ‡น Italian
  • ๐Ÿ‡ต๐Ÿ‡น Portuguese
  • ๐Ÿ‡ฏ๐Ÿ‡ต Japanese
  • ๐Ÿ‡ฐ๐Ÿ‡ท Korean
  • ๐Ÿ‡จ๐Ÿ‡ณ Chinese

The language is automatically detected, but you can pin a Primary Language in Settings for quick translations.


๐Ÿ“ Project Structure

omni-ai/
โ”œโ”€โ”€ manifest.json           # Extension Manifest V3
โ”œโ”€โ”€ background/             # Background service worker
โ”‚   โ””โ”€โ”€ service-worker.js
โ”œโ”€โ”€ content/               # Injected scripts & UI
โ”‚   โ”œโ”€โ”€ content.js          # Core injection logic
โ”‚   โ””โ”€โ”€ overlay.css         # Floating buttons & popups
โ”œโ”€โ”€ lib/                    # Shared logic & AI Providers
โ”‚   โ”œโ”€โ”€ ai-service.js       # AI Dispatcher
โ”‚   โ”œโ”€โ”€ ai-providers.js     # Provider & model definitions
โ”‚   โ”œโ”€โ”€ history.js          # Statistics & History management
โ”‚   โ””โ”€โ”€ providers/          # AI Model Implementations
โ”‚       โ”œโ”€โ”€ gemini.js
โ”‚       โ”œโ”€โ”€ groq.js
โ”‚       โ”œโ”€โ”€ openai.js
โ”‚       โ””โ”€โ”€ custom-gateway.js
โ”œโ”€โ”€ assets/                 # Branding & High-res icons
โ”œโ”€โ”€ settings.html           # Main configuration page
โ”œโ”€โ”€ settings.js
โ”œโ”€โ”€ settings.css
โ”œโ”€โ”€ popup/                  # Extension Popup
โ”‚   โ”œโ”€โ”€ popup.html
โ”‚   โ”œโ”€โ”€ popup.js
โ”‚   โ””โ”€โ”€ popup.css
โ””โ”€โ”€ scripts/                # Build & Utility scripts
    โ””โ”€โ”€ publish.sh          # Automates ID key removal & zipping

๐Ÿ› ๏ธ Tech Stack

  • Manifest V3: Using the latest Chrome extension standards.
  • Vanilla JavaScript: Lightweight, no heavy frameworks, maximum performance.
  • Modern CSS: Variables, Flex/Grid, Glassmorphism, and smooth animations.
  • Provider Architecture: Easily extendable to add new AI providers (OpenAI, Anthropic, etc.).

๐Ÿ“ฆ Publishing to the Chrome Web Store

Follow this guide to publish Omni AI to the official Chrome Web Store.

1. Prepare the Distribution Zip

First, you need to create a clean .zip file containing only the necessary files for the extension to run.

Automated Build Script (Recommended)

We provide a script that automatically handles versioning and removes the development key field (required for OAuth locally but forbidden on the Web Store).

# Make the script executable (first time only)
chmod +x scripts/publish.sh

# Run the build script
./scripts/publish.sh

This will create omni-ai-vX.X.X.zip in the root directory, ready for upload.

2. Create a Developer Account

To publish on the Chrome Web Store, you need a Google Developer account.

  1. Go to the Chrome Web Store Developer Console.
  2. Sign in with your Google Account.
  3. Pay the one-time $5 USD developer registration fee.
  4. Complete your developer profile.

3. Upload and Configure

  1. Upload: Click + New Item and upload your .zip.
  2. Store Listing:
    • Description: Use text from this README.
    • Icons: Use assets/icons/ (ensure 128x128 PNG is available or convert SVG).
    • Screenshots: Upload 1280x800 screenshots of the extension in action.
    • Category: Productivity or Search Tools.
  3. Privacy & Permissions:
    • Single Purpose: "Unified writing assistant and productivity tool".
    • Justification: Explain activeTab, storage, identity, contextMenus usage clearly.
    • Privacy Policy: Link to your privacy policy (GitHub Pages or similar).

Pro Tips for Approval

  • Screenshot Quality: Use high-quality screenshots. Show the โœจ floating button and the Usage Dashboard.
  • Clear Description: Clearly explain that users need an API key (Gemini, OpenAI, Groq) or Custom Gateway to use the extension.
  • Permission Scope: Chrome reviewers prefer the narrowest permissions possible.

๐Ÿค Contributing

Contributions are welcome! Whether it's fixing a bug, adding a new feature, or improving documentation:

  1. Fork the repository.
  2. Create a feature branch: git checkout -b feature/amazing-feature.
  3. Commit your changes: git commit -m 'feat: add amazing feature'.
  4. Push to the branch: git push origin feature/amazing-feature.
  5. Open a Pull Request.

Coding Guidelines

  • Use Vanilla JavaScript (ES6+). Avoid adding external frameworks or heavy libraries.
  • Maintain the CSS Variable system for styling.
  • Ensure any new AI providers follow the existing pattern in lib/providers/.

๐Ÿ“„ License

This project is licensed under the GPL-3.0 License - see the LICENSE file for details.


Made with โค๏ธ by ddtcorex

About

๐Ÿง  All-in-One AI Assistant Chrome Extension powered by multiple AI providers

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors