Gemini-Kchat is a KDE Plasma plasmoid that integrates Google Gemini AI directly into your desktop. Chat with Gemini using the Google AI Studio API without leaving your workspace.
Core Integration
- Direct integration with Google Gemini AI
- Quick chat interface accessible from your Plasma panel
- Native KDE Plasma integration with system theme support
- Fast and lightweight architecture
Model Support
- Multiple Gemini model selection through dropdown menu
- Supported models:
- Gemini 3.1 Pro Preview
- Gemini 3.1 Flash-Lite Preview
- Gemini 3.1 Pro Custom Tools
- Gemini 3 Pro Preview
- Gemini 3 Flash Preview
- Gemini 2.5 Flash
- Gemini 2.5 Pro
- Gemini 2.5 Flash-Lite
- Gemma 3 (27B, 12B, 4B, 1B)
- Gemma 3n (E4B, E2B)
- Deep Research Pro Preview
Session Persistence
- Save and restore chat sessions across restarts
- Multiple session management with easy switching
- Rename and delete sessions
Text-to-Speech
- Multiple TTS provider support:
- ElevenLabs (cloud, high quality)
- OpenAI TTS (cloud)
- espeak-ng (local, fast)
- Piper (local, neural voices)
- Audio caching to avoid re-generating
Customization
- Markdown rendering with syntax highlighting for code blocks
- Customizable system prompts
- Full color and theme customization
- Typography options (font family, size)
- Configurable UI elements (buttons, scrollbars, placeholders)
- Custom icon support
 |
- Download the latest
gemini-kchat.plasmoidfile from the Releases page - Install via command line:
kpackagetool6 -i gemini-kchat.plasmoid
- Right-click on your Plasma panel → "Add Widgets..."
- Search for "Gemini-Kchat" and add it to your panel
- Download the source code ZIP from the Releases page
- Extract and install:
unzip gemini-kchat-vX.X.zip cd Gemini-Kchat kpackagetool6 -i contents --packageroot ~/.local/share/plasma/plasmoids/ -t Plasma/Applet
- Right-click on your Plasma panel → "Add Widgets..."
- Search for "Gemini-Kchat" and add it to your panel
To update to a newer version:
kpackagetool6 -u gemini-kchat.plasmoid- Right-click on the Gemini-Kchat widget
- Select "Configure Gemini-Kchat..."
- Important: Enter your Google AI Studio API key in the "General" tab
- Select your preferred Gemini model from the dropdown
- Customize your agent with colors, typography and interface options
General Settings & Model Selection
|
AI Personality Prompt
|
Appearance & Colors
|
Code Block Formatting
|
Typography
|
UI Elements
|
Custom Plasmoid Icon
|
|
Note: The widget will not work until you configure your API key. You'll see a reminder message in the chat area if the API key is missing.
To use Gemini-Kchat, you need a Google AI Studio API key (it's free!):
- Visit Google AI Studio
- Sign in with your Google account
- Click "Create API Key" or "Get API Key"
- Select or create a Google Cloud project
- Copy the generated API key
- Paste it in the Gemini-Kchat configuration settings
Important: Keep your API key secure and never share it publicly. The API key is stored locally in your KDE configuration.
Click on the Gemini-Kchat icon in your panel and start chatting with Gemini. Simple as that.
- KDE Plasma 6.0 or later
- Google AI Studio API key
- For local TTS: espeak-ng or piper (optional)
⚠️ Rate Limit ErrorsIf you encounter rate limit errors, make sure you have a valid API key. Generally, API keys work well with the free tier on models like Gemini 2.5 Flash or Gemma 3 27B Instruct. Other models may require billing to be enabled on your Google Cloud project.
This project is licensed under the GNU Lesser General Public License v2.1 - see the LICENSE file for details.
Contributions are welcome! Please feel free to submit pull requests, report issues, or suggest new features.
- Inspired by ChatQT plasmoid by Denys Madureira
- Google AI Studio for providing the Gemini API
- KDE community for the excellent Plasma framework