{"id":17487495,"url":"https://github.com/sctg-development/ai-outlook","last_synced_at":"2025-06-22T12:07:55.175Z","repository":{"id":258217863,"uuid":"864128709","full_name":"sctg-development/ai-outlook","owner":"sctg-development","description":"Enhance your email workflow with AI-powered assistance. This Microsoft Outlook web add-in integrates Groq's advanced language models to offer features like email composition suggestions, automated summarization, and language translation. Customizable prompts and model settings allow for a tailored AI experience directly in your Outlook interface","archived":false,"fork":false,"pushed_at":"2025-04-07T06:30:12.000Z","size":1519,"stargazers_count":20,"open_issues_count":0,"forks_count":6,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-22T12:07:47.905Z","etag":null,"topics":["ai","groq-api","llama3","outlook"],"latest_commit_sha":null,"homepage":"https://sctg-development.github.io/ai-outlook/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sctg-development.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["sctg-development"]}},"created_at":"2024-09-27T14:45:27.000Z","updated_at":"2025-04-07T06:30:16.000Z","dependencies_parsed_at":"2025-04-22T16:41:45.338Z","dependency_job_id":"2a736f89-5066-48a2-9613-0365a265079b","html_url":"https://github.com/sctg-development/ai-outlook","commit_stats":{"total_commits":94,"total_committers":4,"mean_commits":23.5,"dds":0.3829787234042553,"last_synced_commit":"d4e82a6c0e5e12523bf83af0d31ec4580cfad202"},"previous_names":["sctg-development/ai-outlook"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/sctg-development/ai-outlook","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sctg-development%2Fai-outlook","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sctg-development%2Fai-outlook/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sctg-development%2Fai-outlook/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sctg-development%2Fai-outlook/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sctg-development","download_url":"https://codeload.github.com/sctg-development/ai-outlook/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sctg-development%2Fai-outlook/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261289419,"owners_count":23136070,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","groq-api","llama3","outlook"],"created_at":"2024-10-19T03:04:46.491Z","updated_at":"2025-06-22T12:07:50.158Z","avatar_url":"https://github.com/sctg-development.png","language":"TypeScript","funding_links":["https://github.com/sponsors/sctg-development"],"categories":[],"sub_categories":[],"readme":"# AI Outlook Add-in\n\nWelcome to the AI Outlook Add-in, a powerful tool that integrates Groq AI and Sambanova AI capabilities into Microsoft Outlook web, enhancing your email experience. This project aims to provide users with AI-powered assistance in their daily email interactions, making email management more efficient and productive.\n\n## Star the project\n\n**If you appreciate my work, please consider giving it a star! 🤩**\n\n## Status\n  \n  ![GitHub release](https://img.shields.io/github/v/release/sctg-development/ai-outlook)\n  ![GitHub last commit](https://img.shields.io/github/last-commit/sctg-development/ai-outlook)\n  ![GitHub issues](https://img.shields.io/github/issues/sctg-development/ai-outlook)\n  ![GitHub stars](https://img.shields.io/github/stars/sctg-development/ai-outlook)\n\n## Help Wanted\n\nGive us a **star** if you like the project. We are looking for contributors to help us improve the project. If you are interested, please check the [Contributing](#contributing) section.\n\n## Table of Contents\n\n- [AI Outlook Add-in](#ai-outlook-add-in)\n  - [Star the project](#star-the-project)\n  - [Status](#status)\n  - [Help Wanted](#help-wanted)\n  - [Table of Contents](#table-of-contents)\n  - [Overview](#overview)\n  - [Features](#features)\n  - [Screenshot](#screenshot)\n  - [Prerequisites](#prerequisites)\n  - [Installation on Microsoft 365](#installation-on-microsoft-365)\n  - [Installation on Outlook Web (manifest.json not supported)](#installation-on-outlook-web-manifestjson-not-supported)\n  - [Usage](#usage)\n  - [Development](#development)\n  - [Customization](#customization)\n  - [License](#license)\n  - [Privacy Policy](#privacy-policy)\n  - [Contributing](#contributing)\n  - [Support](#support)\n  - [Thanks](#thanks)\n\n## Overview\n\nThe AI Outlook Add-in enhances your email workflow by providing AI-powered assistance directly within your Outlook web interface. By leveraging the OpenAI v1 API, this add-in offers intelligent features to help you compose, analyze, and manage your emails more efficiently.\n\n**Project Repository:** [https://github.com/sctg-development/ai-outlook](https://github.com/sctg-development/ai-outlook)\n\n**Deployed Add-in:** [https://outlook.addin.pp.ua/](https://outlook.addin.pp.ua/manifest.json)\n**Deployed Add-in (GitHub Pages):** [https://sctg-development.github.io/ai-outlook](https://sctg-development.github.io/ai-outlook)\n\n## Features\n\n- AI-powered email composition suggestions\n- Automated email summarization\n- Prompt easy configurable in src/config.ts\n- Model configuration in src/config.ts\n- Language translation integration\n- Compatible with Groq AI and Sambanova AI ([via AI-Proxy-Cloudflare due to CORS](https://github.com/sctg-development/ai-proxy-cloudflare))\n\n## Screenshot\n\n\u003cimg width=\"936\" alt=\"Capture d’écran 2024-10-10 à 18 25 10\" src=\"https://github.com/user-attachments/assets/07041511-626f-465e-ba12-3d6bd54b3b2c\"\u003e\n\u003cimg width=\"1086\" alt=\"Capture d’écran 2024-10-09 à 12 33 19\" src=\"https://github.com/user-attachments/assets/3802ebe4-cf2e-4ee2-ba41-45dc27d94ddc\"\u003e\n\u003cimg width=\"979\" alt=\"Capture d’écran 2024-10-10 à 18 25 47\" src=\"https://github.com/user-attachments/assets/1c905169-3897-452d-ac13-c8b35520948c\"\u003e\n\n## Prerequisites\n\nBefore you can use the AI Outlook Add-in, you'll need:\n\n1. Access to your company's Microsoft 365 admin console\n2. A Groq AI developer API key (obtain one from [Groq's developer portal](https://console.groq.com))\n3. For SambaNova AI, obtain an API key from [SambaNova's developer portal](https://console.sambanova.ai) you also need a proxy for bypassing the lack of CORS headers in the sambanova API. You can use our [AI-Proxy-Cloudflare](https://github.com/sctg-development/ai-proxy-cloudflare) for this purpose.\n\n## Installation on Microsoft 365\n\nTo install the AI Outlook Add-in, follow these steps:\n\n1. Download the latest release (nightly) ZIP file from the [project's GitHub releases section](https://github.com/sctg-development/ai-outlook/releases).\n   1. Note release_*.zip use Cloudflare Pages for hosting the add-in.\n   2. Note release_github_pages_*.zip use GitHub Pages for hosting the add-in.\n2. Log in to your company's Microsoft 365 admin console.\n3. Navigate to Settings \u003e Integrated applications.\n4. Click on \"Load customized applications\" (or a similar option for adding custom add-ins).\n5. Upload the ZIP file you downloaded in step 1.\n6. Follow any additional prompts to complete the installation process.\n\nNote: The exact steps may vary slightly depending on your organization's Microsoft 365 configuration. If you encounter any issues, please contact your IT administrator for assistance.\n\n## Installation on Outlook Web (manifest.json not supported)\n\nTo install the AI Outlook Add-in on Outlook web if you cannot use a zip or xml file, follow these steps:\n\n1. Open Outlook on the web and sign in to your account.\n2. Download the latest [manifest.xml](https://outlook.addin.pp.ua/manifest.xml) or build yours.  \n3. Navigate to Settings \u003e Integrated applications.\n4. Click on \"Load customized applications\" (or a similar option for adding custom add-ins).\n5. Upload the XML file you downloaded in step 2.\n6. Follow any additional prompts to complete the installation process.\n\nNote: The icon may not appear in the ribbon immediately after installation. If you don't see it, try refreshing the page or restarting your browser.\n\n## Usage\n\nAfter installation:\n\n1. Open Outlook on the web and sign in to your account.\n2. Open an email or start composing a new message.\n3. Look for the AI Outlook Add-in called **AI emailer** icon in the Outlook ribbon.\n4. Click on the icon to open the add-in pane.\n5. Enter your Groq AI developer API key when prompted (this is a one-time setup).\n6. Use the add-in features as needed in your email workflow:\n   - For composition assistance, select the text you want to improve and use the relevant feature.\n   - For email summarization, open the email you want to summarize and use the summarization feature.\n   - For translation, select the text to translate and choose the target language.\n\nRefer to the in-app instructions for more detailed usage guidelines.\n\n## Development\n\nTo set up the development environment:\n\n1. Clone the repository: `git clone https://github.com/sctg-development/ai-outlook.git`\n2. Install dependencies: `npm install`\n3. Sign in Office 365: `npm run signin`\n4. Start the development server: `npm start`\n\n## Customization\n\nYou can customize the AI Outlook Add-in by modifying the `src/config.ts` file.  \nYou'll also need to update the `manifest.json` file to reflect your deployment settings.  \n\n## License\n\nThis project is licensed under the GNU Affero General Public License v3.0 (AGPLv3). For more details, see the [LICENSE](LICENSE.md) file in the project repository.\n\n## Privacy Policy\n\nPlease refer to the [PRIVACY.md](PRIVACY.md) file for information on data collection, usage, and privacy practices related to the Groq Outlook Add-in.\n\n## Contributing\n\nWe welcome contributions to the AI Outlook Add-in! If you'd like to contribute, please follow these steps:\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n## Support\n\nIf you encounter any issues or have questions about the AI Outlook Add-in, please [open an issue](https://github.com/sctg-development/ai-outlook/issues) on our GitHub repository.\n\n---\n\nThis project is not affiliated with or endorsed by Microsoft, Meta, SambaNova or Groq. It is an independent add-in developed to enhance the Outlook web experience using Groq's AI capabilities and Meta Llama models.\n\n## Thanks\n\nThank you to Groq for giving us access for free to their AI API. We are grateful for their support and collaboration.\n\n[![Powered by Groq for fast inference.](https://groq.com/wp-content/uploads/2024/03/PBG-mark1-color.svg)](https://groq.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsctg-development%2Fai-outlook","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsctg-development%2Fai-outlook","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsctg-development%2Fai-outlook/lists"}