Desktop Plugin

Plugin Windows macOS

Tip

The Prodgy Assistant desktop plugin allows you to run the meeting agent directly on your machine, with email monitoring via IMAP and local transcription.

What is the Desktop Plugin?

The desktop plugin is a version of Prodgy Assistant that runs locally on the user’s machine. It monitors a configured email mailbox via IMAP, detects Microsoft Teams meeting invitations, and automatically joins meetings to capture transcriptions.

This mode is ideal for:

• Environments that don’t use Microsoft 365
• Organizations that prefer local control over processing
• Users with email providers that support IMAP (Gmail, Outlook, etc.)

System Requirements

Windows

• Operating System: Windows 10 or later (64-bit)
• Administrator Rights: Installation requires administrative privileges
• Disk Space: Approximately 1 GB of free space
• Internet Connection: Required for webhooks and email configuration

macOS

• Operating System: macOS 12 (Monterey) or later
• Administrator Rights: Required for installation
• Disk Space: Approximately 1 GB of free space
• Internet Connection: Required for webhooks and email configuration

Installation Wizard

The installation process is guided by a wizard that automatically configures all necessary components.

1. Run the installer

   Download the Prodgy Assistant Setup file and run it:

   • Windows: Prodgy Assistant Setup.exe
   • macOS: Prodgy Assistant.dmg

   If prompted by the operating system, confirm that you trust the publisher.

2. License Agreement

   Read and accept the Terms of Use. Select the transcription language:

   • Portuguese (pt) — For transcription in Portuguese
   • English (en) — For transcription in English

3. Email Configuration

   Configure the email account the plugin will use to receive meeting invitations:

   • Email address: Email where invitations will be received
   • App Password: Application-specific password (not your regular password)
     • Gmail: generate an App Password in account settings
     • Other providers: check your provider’s documentation

   IMAP Configuration:

   • Host: Pre-configured based on email provider
   • Port: Typically 993 for secure connections
   • Encryption: SSL/TLS, STARTTLS, or no encryption

4. Webhook Configuration

   Configure the communication channel with the Prodgy platform:

   • Webhook URL: Secure endpoint provided by your Prodgy account (must start with https://)
   • User/ID (optional): Webhook identifier
   • Password/Token (optional): Authentication token

   Click Test Connection to validate the configuration.

5. Review settings

   Review the summary with all settings:

   • Email configuration status
   • Webhook endpoint and credentials
   • Selected transcription language
   • Additional options (desktop shortcut, auto-start)

6. Complete installation

   The system will:

   • Copy application files
   • Install the Python runtime (embedded)
   • Configure the virtual environment with dependencies
   • Create configuration files
   • Optionally create a desktop shortcut
   • Optionally configure auto-start with the system

Caution

The webhook URL must use HTTPS. HTTP URLs will be rejected during installation. We recommend creating a dedicated email account for the plugin.

After Installation

1. Choose to launch the plugin immediately or run it manually later
2. Check the system tray to confirm the plugin is running
3. Verify that email and webhook connections are active

Troubleshooting

Installation Failure

• Ensure you have administrator privileges
• Check that you have at least 2 GB of free disk space
• Confirm your internet connection is stable
• Temporarily disable antivirus if necessary

Email Connection Issues

• Verify the email address is correct and has a valid app password
• Confirm that IMAP is enabled in account settings
• Check that IMAP host and port match your provider

Webhook Connection Failure

• Verify the URL starts with https://
• Test the URL in a browser to confirm accessibility
• Contact your Prodgy administrator to validate the endpoint

Uninstallation

Windows

1. Open Control Panel → Programs and Features
2. Find Prodgy Assistant and click Uninstall
3. Follow the prompts and restart your computer

macOS

1. Drag Prodgy Assistant from the Applications folder to Trash
2. Empty Trash to completely remove it

Note

Uninstallation removes application files and configuration. Consult your Prodgy administrator if you need to backup any information before uninstalling.

Support

For additional assistance:

• Consult the documentation at prodgy.ai
• Contact the Prodgy support team
• Refer to your email provider’s documentation for authentication issues

Visit Prodgy