Summary

This project provides a framework for integrating AI chat panels into Microsoft Office Add-ins, enabling users to interact with documents using their own Large Language Model (LLM) credentials (BYOK). It targets developers and power users seeking to build custom, AI-driven workflows within Word, Excel, and PowerPoint, offering enhanced document manipulation capabilities through built-in tools, a virtual filesystem, and a sandboxed shell.

How It Works

The monorepo is structured around a headless SDK (@office-agents/sdk) that manages the agent runtime, tools, storage, virtual filesystem (VFS), skills, OAuth, and web search functionalities. A core package (@office-agents/core) provides the React-based chat UI, re-exporting the SDK and offering chat components, settings, and session management. Specific add-ins for Excel (@office-agents/excel) and PowerPoint (@office-agents/powerpoint) leverage Office.js wrappers and system prompts to integrate deeply with their respective applications. The "Bring Your Own Key" (BYOK) approach ensures users control their API keys and data privacy.

Quick Start & Requirements

• Install: pnpm install
• Run: pnpm dev-server:excel (for Excel dev server), pnpm start:excel (to launch Excel with add-in sideloaded). Similar commands exist for PowerPoint (dev-server:ppt, start:ppt).
• Prerequisites: pnpm (Node.js package manager).
• Links: See each package's README for install instructions and tool documentation.

Highlighted Details

• Supports a wide range of LLM providers via API key (BYOK), including OpenAI, Anthropic, Google, Azure, and Mistral, as well as custom OpenAI-compatible endpoints.
• Offers OAuth integration for specific providers like Anthropic and OpenAI Codex.
• Features a virtual filesystem (VFS) and a sandboxed shell for advanced document interaction and tool execution.
• Integrates web search and fetch capabilities using providers such as DuckDuckGo, Brave, Serper, and Exa.
• Allows installation and management of custom "skills" from Markdown files or folders.

Maintenance & Community

No specific details on contributors, sponsorships, or community channels were provided in the README.

Licensing & Compatibility

• License: MIT
• Compatibility: The MIT license generally permits commercial use and integration into closed-source projects. However, the project is explicitly marked as not production-ready.

Limitations & Caveats

This project is explicitly stated as "not production-ready" and is not intended for publication to the Microsoft Add-in Store. It serves primarily as a framework and reference for building custom Office-based AI agents.