Installation

How to download and install TurboMail on your computer.

System Requirements

• macOS: macOS 12.0 or later (Apple Silicon recommended for local AI).
• Windows: Windows 10 or 11 (64-bit).
• Memory: Minimum 8GB RAM (16GB recommended if using local AI heavily).

Installing on macOS

1. Download the .dmg file from the Download page.
2. Open the downloaded file.
3. Drag the TurboMail app icon into your Applications folder.
4. Open Launchpad or Finder and launch TurboMail.

Installing on Windows

1. Download the .exe installer from the Download page.
2. Double-click the installer to run it.
3. Follow the on-screen prompts to complete the installation.
4. Launch TurboMail from your Start menu or desktop shortcut.

Connecting Accounts

Add your email accounts to start using TurboMail.

Supported Providers

TurboMail currently supports:

• Google Workspace / Gmail (via OAuth)
• Microsoft Outlook / Office 365 (via OAuth)
• Standard IMAP / SMTP

How to Add an Account

1. Open TurboMail and navigate to Settings (the gear icon).
2. Click on the Accounts tab.
3. Click Add Account.
4. Select your provider (Google, Microsoft, or IMAP).
5. Follow the browser authentication flow. Once authenticated, you will be redirected back to the app.

Turbo AI Search

Ask questions about your inbox and get intelligent, sourced answers.

How it Works

Instead of just searching for keywords like "invoice", you can ask natural language questions:

"What invoices are due this week?"
"Summarize the recent thread with the design team."
"Did Sarah send the Q3 report yet?"

Source Links

Every claim the AI makes is backed by a source link. When the AI answers your question, you will see buttons labeled Source 1, Source 2, etc. Clicking these will immediately open the exact email the AI referenced.

Local vs Cloud AI

Choose where your data is processed.

Local Mode (Default)

By default, TurboMail uses Turbo AI 1.5B, a lightweight model that runs directly on your CPU/GPU. In this mode:

• Zero data leaves your machine for AI processing.
• Works entirely offline.
• Fastest for simple summaries and searches.

Cloud Mode (Bring Your Own Key)

If you need deeper reasoning or better drafting capabilities, you can plug in an API key from OpenAI, Anthropic, or Google.

1. Go to Settings > Models.
2. Select your provider.
3. Paste your API key.
4. Toggle the model in the top navigation bar of the main app.

Composing Emails

Draft and send emails from any of your connected accounts.

When composing an email, TurboMail provides a multi-account selector so you never accidentally send a work email from your personal account.

AI Drafts

Click the AI Assist button in the composer to have TurboMail write a draft for you. You can provide a brief instruction like:

"Politely decline the invitation and suggest meeting next Tuesday instead."

The AI will generate the text which you can then edit before sending.

Calendar Integration

Manage your schedule alongside your emails.

Turbo Calendar

When you connect a Google or Outlook account, TurboMail can automatically sync your calendar events. You can view your upcoming schedule in the Calendar tab on the left rail.

Turbo Link

Turbo Link is a built-in scheduling feature. You can generate a link to share with others, allowing them to book time on your calendar based on your availability rules, without needing a third-party service.

AI Agents

Automate repetitive email tasks using custom AI agents.

Agents are background workers that scan incoming emails and perform actions based on rules you define.

Example Agents

• Invoice Watcher: Automatically tags emails containing invoices and marks them as "Finance".
• Reply Assistant: Drafts proposed replies to common customer support questions and places them in a "Needs Review" queue.

Creating an Agent

Go to the Agents tab and click New Agent. Define the trigger (e.g., "When an email arrives from @acme.com") and the action (e.g., "Draft a reply saying we received it").

Keyboard Shortcuts

Navigate TurboMail quickly using your keyboard.

Global Navigation

• Cmd/Ctrl + 1: Go to Inbox
• Cmd/Ctrl + 2: Go to Search
• Cmd/Ctrl + 3: Go to Agents
• Cmd/Ctrl + K: Open Command Palette

Email Actions

• C: Compose new email
• R: Reply
• A: Reply All
• E: Archive
• #: Delete
• /: Focus search bar

Frequently Asked Questions

Is TurboMail free?

During the public beta, TurboMail is free to use. We plan to introduce a paid tier for advanced features (like hosted cloud models) in the future, but the local-first core app will remain accessible.

Where is my email data stored?

Your emails are stored securely on your local hard drive in an encrypted database. TurboMail does not harvest your inbox or send your emails to our servers.

Does the local AI slow down my computer?

Turbo AI 1.5B is highly optimized and designed to run quietly in the background. It only utilizes heavy compute when actively indexing new batches of emails or answering a search query.

Troubleshooting

Emails are not syncing

If your inbox stops syncing, try the following:

1. Go to Settings > Accounts and check if the account requires re-authentication.
2. Ensure you have a stable internet connection.
3. Restart the TurboMail application.

Local AI is very slow

If answers take more than 10-15 seconds to generate:

• Check if you have other heavy applications running (like video editors or games).
• Ensure your device is plugged in (some laptops throttle performance on battery).

If you still need help, please contact support.