README

GenIA — AI Email Assistant for Roundcube

The missing AI for your self-hosted email.
Compose, rewrite, reply, translate, summarize, scam check — works with OpenAI, Claude, Grok, Ollama, or any local LLM.

Features • Installation • Configuration • Usage • FAQ • Contributing

Why?

Gmail has Gemini. Outlook has Copilot. Your self-hosted Roundcube has... nothing. Until now.

GenIA brings the same AI-powered email experience to your own mail server. No vendor lock-in. Point it at a local Ollama instance and zero data leaves your network. Or use cloud providers like OpenAI and Grok when convenience matters. Your server, your choice.

Features

Seven Powerful Actions

Quick Actions Toolbar (Read View)

When reading an email, a toolbar appears above the message body with one-click actions:

• Translate — dropdown with 7 languages, streams translation inline, "Show Original" to revert
• Summarize — streams a summary in a result panel above the email
• Scam Check — analyzes the email with color-coded verdict (green/yellow/red)
• Reply with AI — opens the full GenIA panel in reply mode

Multi-Provider Support

Switch between AI providers directly in the UI. Mix cloud and local:

AI Controls

• Reasoning Effort — None / Low / Medium / High
• Verbosity — Concise / Balanced / Detailed
• Language — Portuguese, English, Spanish, French, German, Italian, Dutch
• Tone — Professional, Casual, Friendly, Formal, Urgent

Smart Features

• Streaming responses — see the AI write in real-time
• Conversation memory — chain instructions: "make it shorter", "now translate it"
• Preview before applying — review AI output before it touches your email
• Undo — one-click revert after applying
• Copy to clipboard — copy AI results with one click
• Persistent preferences — provider, model, language, tone saved across sessions
• Keyboard shortcut — Alt+A to toggle the GenIA panel
• Token counter — see input/output token usage per request

UI

• Floating GenIA button (bottom-right corner)
• Quick actions toolbar in read view
• Modal panel with backdrop blur
• Dark mode support
• Fully responsive on mobile

Installation

Option 1: Git Clone (Recommended)

cd /path/to/roundcube/plugins/
git clone https://github.com/eduardostern/roundcube-genia.git lifeprisma_ai
cd lifeprisma_ai
cp config.inc.php.dist config.inc.php

Edit config.inc.php and add your API keys.

Enable the plugin in Roundcube's config/config.inc.php:

$config['plugins'] = [
    // ... your other plugins
    'lifeprisma_ai',
];

Option 2: Composer

cd /path/to/roundcube/
composer require lifeprisma/roundcube-genia

Option 3: Manual Download

1. Download the latest release
2. Extract to plugins/lifeprisma_ai/
3. Copy config.inc.php.dist to config.inc.php
4. Add your API keys and enable the plugin

Configuration

Ollama (Local — Zero Data Leaves Your Network)

<?php
$config['lifeprisma_ai_providers'] = [
    'ollama' => [
        'label'    => 'Ollama',
        'api_url'  => 'http://localhost:11434/v1/chat/completions',
        'api_type' => 'chat_completions',
        'api_key'  => '',
        'model'    => 'llama3.1',
        'models'   => ['llama3.1', 'mistral', 'qwen2.5'],
        'supports_reasoning' => false,
    ],
];

Install Ollama: curl -fsSL https://ollama.com/install.sh | sh && ollama pull llama3.1

Cloud Providers (OpenAI + Claude + Grok)

<?php
$config['lifeprisma_ai_providers'] = [
    'openai' => [
        'label'    => 'GPT',
        'api_url'  => 'https://api.openai.com/v1/responses',
        'api_type' => 'responses',
        'api_key'  => 'sk-proj-xxxxx',
        'model'    => 'gpt-5.4',
        'models'   => ['gpt-5.4', 'gpt-4.1'],
    ],
    'anthropic' => [
        'label'    => 'Claude',
        'api_url'  => 'https://api.anthropic.com/v1/messages',
        'api_type' => 'anthropic',
        'api_key'  => 'sk-ant-xxxxx',
        'model'    => 'claude-sonnet-4-6',
        'models'   => ['claude-sonnet-4-6', 'claude-haiku-4-5-20251001'],
        'supports_reasoning' => false,
    ],
    'xai' => [
        'label'    => 'Grok',
        'api_url'  => 'https://api.x.ai/v1/responses',
        'api_type' => 'responses',
        'api_key'  => 'xai-xxxxx',
        'model'    => 'grok-4.1-fast',
        'models'   => ['grok-4.1-fast', 'grok-3'],
    ],
];

Mix Local + Cloud (Best of Both Worlds)

<?php
$config['lifeprisma_ai_providers'] = [
    'ollama' => [
        'label'    => 'Local',
        'api_url'  => 'http://localhost:11434/v1/chat/completions',
        'api_type' => 'chat_completions',
        'api_key'  => '',
        'model'    => 'llama3.1',
        'models'   => ['llama3.1', 'mistral'],
        'supports_reasoning' => false,
    ],
    'openai' => [
        'label'    => 'GPT',
        'api_url'  => 'https://api.openai.com/v1/responses',
        'api_type' => 'responses',
        'api_key'  => 'sk-proj-xxxxx',
        'model'    => 'gpt-5.4',
        'models'   => ['gpt-5.4', 'gpt-4.1'],
    ],
];

Users can switch between local and cloud in the UI. Use local for privacy, cloud for quality.

API Type Reference

Global Settings

Usage

1. Log into Roundcube webmail
2. Open a compose window or view an email
3. Click the GenIA button (bottom-right) or press Alt+A
4. Choose an action, set your preferences, and generate

Keyboard Shortcuts

Tips

• Quick translate: Use the toolbar above the email — no panel needed
• Chain actions: Compose in Portuguese, translate to English, change tone to Formal
• Scam check: Auto-analyzes SPF, DKIM, and authentication headers
• Persistent settings: Your provider, language, and tone are remembered

Compatibility

Privacy & Security

GenIA is designed with privacy-conscious self-hosters in mind:

• Local LLM = zero data leaves your network. Point GenIA at Ollama or any local model and your emails never touch an external server
• Cloud providers: when using OpenAI/Grok, email content is sent to their API for processing. These providers have data usage policies — API data is not used for training by default
• API keys stay on your server — never sent to the browser
• No telemetry, no tracking, no analytics — the plugin makes zero external calls except to your configured AI endpoint
• No phone-home, no registration — install and use, that's it
• Open source (MIT) — audit every line of code yourself

Recommended Setup for Maximum Privacy

Use Ollama with a local model. No API keys needed, no external calls, no data exposure:

'ollama' => [
    'label'    => 'Local',
    'api_url'  => 'http://localhost:11434/v1/chat/completions',
    'api_type' => 'chat_completions',
    'api_key'  => '',
    'model'    => 'llama3.1',
    'models'   => ['llama3.1'],
    'supports_reasoning' => false,
],

FAQ

Q: Which AI providers are supported? A: OpenAI (GPT), Anthropic (Claude), xAI (Grok), Ollama, LM Studio, LocalAI, vLLM, and any OpenAI-compatible endpoint. Responses API, Anthropic Messages API, and Chat Completions API formats are all supported.

Q: Does it send my emails to an external server? A: Only if you configure a cloud provider (OpenAI, Grok). If you use Ollama or another local LLM, zero data leaves your network. You choose.

Q: Can I run it fully offline / air-gapped? A: Yes. Use Ollama or any local model server. No internet connection needed after initial model download.

Q: How much does it cost? A: The plugin is free (MIT). If using cloud providers, you pay for API usage (~$0.001-0.01 per email). Local models are completely free.

Q: I see "GenIA is not configured yet" — what do I do? A: Your server admin needs to add API keys to the config file. See Configuration above.

Troubleshooting

"GenIA is not configured yet"

The plugin needs at least one AI provider with an API key. Create or edit your config file:

cp plugins/lifeprisma_ai/config.inc.php.dist plugins/lifeprisma_ai/config.inc.php

Then add your API keys:

<?php
$config['lifeprisma_ai_providers'] = [
    'openai' => [
        'label'   => 'GPT',
        'api_url' => 'https://api.openai.com/v1/responses',
        'api_key' => 'sk-proj-xxxxx',  // Get yours at platform.openai.com/api-keys
        'model'   => 'gpt-5.4',
        'models'  => ['gpt-5.4', 'gpt-4.1'],
    ],
];

Make sure the file is readable by your web server:

chown root:www-data plugins/lifeprisma_ai/config.inc.php
chmod 640 plugins/lifeprisma_ai/config.inc.php

"API key not configured"

This means the provider you selected doesn't have an API key set. Check your config.inc.php and make sure the api_key field is filled for each provider.

Contributing

Contributions welcome! Fork, branch, PR.

Support the Project

This plugin is 100% free and open source. If it helps you:

• Try LifePrisma.ai — our AI platform
• Star this repo on GitHub
• Share feedback via GitHub Issues

License

MIT License — Free to use, modify, and distribute.

See LICENSE for full terms.

Built by Eduardo Stern / LifePrisma.ai