Same message. Kinder tone.
A calmer way
to read your email.
Kindifier uses AI to soften the tone of incoming Gmail messages and help you write kinder replies. It aims to preserve the meaning, requests and boundaries. Originals stay hidden unless you choose Show original.
Read before trying itPlease read carefully
Source code shared for independent use.
I am sharing experimental source code in a public repository. I am not offering to install, operate or support the software for anyone, and I am not providing a public hosted email or AI service. If you choose to use it, you download, configure and run your own copy, using your own accounts and credentials. Sharing this code creates no commitment from me to maintain it or provide updates.
The code is available under the MIT License, including its warranty disclaimer and limitation of liability. Use of the code is governed by that license. Third-party components retain their own licenses. It is not a supported email service.
The software is provided “as is” and “as available,” without warranties to the extent permitted by applicable law. There is no commitment to support, maintenance, security updates or continued availability. Nothing in this notice limits rights that cannot lawfully be excluded.
AI can omit details, misinterpret intent or change meaning. Do not rely on a rewrite as the sole record of an important communication. Check the original when accuracy matters, and review the recipient and final text before sending. Start with non-sensitive test messages.
Your email is sent to an AI provider.
In the local version, your computer connects to Gmail and sends email subjects and body text over the internet to the AI service you choose. When you ask it to rewrite a reply or a new message, your draft subject and text are sent too. The selected text can include names, addresses, signatures and quoted conversations. This is not offline processing.
If you choose OpenAI
The selected email text is sent to OpenAI using your own API key.
If you choose OpenRouter
The selected email text is sent to OpenRouter and the model provider it routes the request to, using your own OpenRouter key.
The relevant providers’ terms, privacy and retention policies apply. You pay any API charges on your account. Only process email you are authorized to share with those services, and check any workplace or confidentiality requirements first.
- Newest 20 messages: after you acknowledge the disclosure, automatic preparation is enabled by default. You can switch it off during setup or pause it later. Loading or refreshing the inbox prepares the newest 20 messages and reuses successful cached rewrites for up to seven days. Further requests can incur charges. “Prepare” means rewrite for you to read; it never means send an outgoing email.
- 5,000-token input limit per email: only the beginning is sent, counting the subject and input formatting. Longer messages show a partial-rewrite warning, and the rest stays hidden until you choose Show original. AI instructions and generated output use additional tokens; this is not a total billing or spending cap. Attachments are not sent to the AI provider.
- Local storage: the installed version keeps credentials in your operating system’s credential store and encrypted mail records on your computer. The author does not receive your email or keys through this local application.
Opening this instructions page does not connect Gmail or send email to an AI provider. The separate owner’s hosted inbox uses its existing hosted credentials and storage; the local-storage description above does not apply to that older hosted version.
Run it on your own computer.
The source code and full instructions are available in the public Kindifier repository on GitHub. You run the app yourself, using your own Gmail account, Google Cloud setup and OpenAI or OpenRouter API account. No shared API key or developer-operated service is included.
Prepare your computer
Install Node.js 24 or later and Git. Use a desktop browser and an unlocked system credential store: macOS Keychain, Windows Credential Manager or Linux Secret Service.
Install from the public repository
In a terminal, run:
git clone https://github.com/reliableai/kindifier.git cd kindifier npm ci --foreground-scripts npm run build npm startYour browser opens the local app. Keep the terminal open while using it; press Ctrl+C to stop.
Set up your own Gmail connection
In Google Cloud, create a project, enable the Gmail API and configure Google Auth Platform. If the app is External and in Testing, add your own Gmail address as a test user. Create an OAuth client of type Desktop app and download its JSON file. Use that file in Kindifier’s local setup. Google may show an unverified-app warning, and Testing mode can require you to reconnect after seven days. Do not use a Web application client or kindifier.com as the local callback.
Choose your AI service and read the disclosure
Select OpenAI or OpenRouter, choose a supported model, enter your own API key and select your Google Desktop JSON file. The local version currently supports GPT-4.1 mini and GPT-4o mini, directly or through OpenRouter. Decide whether to automatically prepare the newest 20 messages, then acknowledge the disclosure and select Save locally & enable rewrites.
Connect and try a harmless message
Select Connect Gmail. Check the Google account and requested permissions before authorizing. If automatic preparation is enabled, the newest 20 messages will then be sent for rewriting. To test only one harmless message first, turn automatic preparation off before connecting. Sending an outgoing message always requires your review and confirmation.
Current testing limits: macOS installation and first-run setup have been checked. Live Gmail connections and live AI requests through either OpenAI or OpenRouter in this local release, and Windows/Linux installation, have not yet been verified. Gmail and other mail apps can still show original text in their notifications.
Existing private hosted inbox
Kindmail is the owner’s earlier hosted version, separate from the install-it-yourself prototype described above.
Open owner’s hosted inbox (private — sign-in required)