MkDocs Gemini Chat Plugin

A Material for MkDocs plugin that adds a Gemini-powered chat window to your documentation pages.

Features

• Interactive chat window powered by Google's Gemini 2.5 Pro
• Chat history and context support
• Multiple language support
• Version-specific documentation support
• File path specification
• Copy/download functionality
• Customizable UI position

Installation

pip install mkdocs-gemini-chat

Configuration

1. First, obtain a Gemini API key from Google AI Studio.

2. Add your API key to your environment:

   # In your .env file or export in your shell
   export GEMINI_API_KEY=your_api_key_here
   

3. Add the plugin to your mkdocs.yml:

   plugins:
     - gemini-chat:
         # Optional: Configure UI position
         position: bottom-right  # Options: bottom-right, bottom-left, top-right, top-left
         # Optional: Set default language
         default_language: en
         # Optional: Set documentation version
         version: latest
   

Usage

Once configured, the chat window will appear on your documentation pages. Users can:

• Ask questions about the documentation
• Specify file paths for context
• Change language settings
• Access version-specific information
• Copy or download chat responses

Requirements

• Python 3.8 or higher
• A valid Gemini API key
• MkDocs 1.0.0 or higher

Development

To contribute or run tests:

# Clone the repository
git clone https://github.com/nolanblevins/mkdocs-gemini-chat.git
cd mkdocs-gemini-chat

# Install development dependencies
pip install -e ".[dev]"

# Run tests
pytest tests/

License

MIT License - see LICENSE file for details.

Original Requirements

References

• DeepWiki
• DeepSeek Chat