Welcome to the Omni Max repository

English · Português · Español

---

Hey there, agent! Ever wished you had a superpower to handle the daily grind of customer service?
We know how challenging the job can be. That's why we created Omni Max: the AI extension that every customer service professional deserves.
With conversation summaries, response assistance, magic templates, and life-saving shortcuts, your experience is about to change.
Your only frustration will be not having discovered this sooner. 😉

❤️ About the Project

Important

Omni Max was born from a real need: customer service work doesn't have to be so exhausting. If you agree, star this repository to give us a boost! ⭐️

Omni Max is your new secret weapon for the ASC SAC platform (and its white-label variations). A supercharged friend with Artificial Intelligence, designed to automate the boring and repetitive tasks.

Our goal is simple: reduce stress, optimize your time, and allow you to focus on what really matters: delivering exceptional, human-centered service.

📌 Get Omni Max

Omni Max is currently available for Google Chrome, Microsoft Edge, and Mozilla Firefox.

Get it now at:

✨ What Does Omni Max Actually Do?

Omni Max has evolved! In addition to the classic features, you now have a true AI ecosystem at your disposal:

• 🤖 AI with Full Context for Real Help: The assistant arrives knowing everything! It reads the entire conversation with the customer and uses LangChain and LangGraph to give you relevant help, without you wasting time explaining the obvious.

• 🧠 Your Private Response Library: Upload manuals, procedures, or any document (.md, .txt). The AI consults this base to provide accurate answers based on your data. It's like having your company's expert available 24/7.

• 🎭 The AI Actor: Want the AI to sound like a "Billing Expert" or a "Friendly Tier 1 Support"? You create the "Personas," define the tone of voice, the rules, and even which tools it can use. You're the director!

• 🛠️ Tools Up Its Sleeve: The AI doesn't pull answers out of thin air, it searches for them! With access to tools like your knowledge base, the information is always fact-based.

• 🔗 You Choose the Magic: Prefer OpenAI? A fan of Google Gemini? Or want to use a model running on your own PC with Ollama? You're in charge here. Connect your favorite AI provider.

And for the day-to-day?

• 📝 Magic Templates: Answer frequent questions with a click. Insert names and variables automatically, quickly, and without errors.

• 🖱️ Life-Saving Shortcuts: Copy name, ID, and other information with a simple keyboard shortcut. It's almost... magic.

• 🎨 The Layout is Yours: Does the conversation list on the right bother you? Move it to the left! Adjust the small details of the interface so everything is exactly where you like it.

• ⚙️ You're in Command (Modular Design): Omni Max adapts to you. Enable or disable each feature to create your perfect work experience.

🛠️ What's Under the Hood? (Main Technologies)

• LangChain – A library to orchestrate calls to AI providers (OpenAI, Anthropic, Google GenAI, etc.), used in the Agent.

• LangGraph – An extension of the LangChain library for building stateful agents, used to give the assistant the ability to remember context, use tools to fetch context, query the knowledge base, and more.

• IndexedDB: Used for the knowledge base VectorStore and for saving the agent's conversation state (Checkpointer).

• Svelte (v5) – A lightweight reactive framework for building the UI.

• TypeScript – Static typing and autocompletion, ensuring more robust code.

• CRXJS Vite Plugin – A plugin that integrates Manifest V3 into the Vite workflow, necessary for modern Chrome extensions.

• Vitest + Vitest-Chrome – Unit and integration testing suite specific to extension environments.

• Github Actions – CI/CD for checking (svelte-check), testing, building, and automatically deploying to the Chrome Web Store.

🎯 Target Platform

This extension is designed to integrate with and enhance the user experience on the ASC SAC omnichannel customer service platform, and can also be adapted for the white-label variations from ASC Brasil.

🚀 Getting Started

Installation (for Users)

For detailed usage instructions, please refer to our User Guide.

Prerequisites

• Node.js (LTS version recommended)
• npm (comes with Node.js) or yarn / pnpm

Development Setup

To set up Omni Max for development:

1. Clone the repository:

   git clone [https://github.com/DevDeividMoura/omni-max.git](https://github.com/DevDeividMoura/omni-max.git)
   cd omni-max

2. Install dependencies:

   npm install
   # or yarn install / pnpm install

3. Run in development mode:

   npm run dev

4. Load the unpacked extension in Chrome:

   • Open Chrome and navigate to chrome://extensions.
   • Enable "Developer mode" using the toggle switch.
   • Click the "Load unpacked" button.
   • Select the dist directory from your project folder.

Omni Max should now be installed and active for development.

🔧 Configuration

Omni Max is highly configurable through its side panel. You can:

• Enable or disable the extension globally.
• Activate or deactivate each module individually.
• Choose your AI provider (OpenAI, Gemini, Ollama) and manage your credentials (API keys or URLs).
• Select specific Chat and Embedding models.
• Create and manage AI Personas.
• Add and remove documents from your Knowledge Base.
• Customize keyboard shortcuts.

🏗️ Building for Production

To create a production-ready build of the extension (e.g., for packing and submitting to the Chrome Web Store):

npm run build

This will generate optimized files in the /dist directory.

🤝 Want to Be a Part of This?

Awesome! Omni Max is an open-source project and we would love to have your help.

To contribute, please read our Contribution Guide. It has everything you need to know about our workflow, code standards, and how to submit your pull requests.

📝 License

This project is licensed under the MIT License. See the LICENSE file for more details.

---

Made with ❤️ by @DevDeividMoura