Gemini-Discord-Bot - GitLite

KO | EN

gitlite — search

#javascript #python #hacktoberfest #typescript #rust #deep-learning #cli #kubernetes #awesome-list #security #pytorch #mcp #ios #openai

Gemini-Discord-Bot

(★ 98)

A Discord bot leveraging Google Gemini. Has image/video/audio recognition, conversation engagement, and content understanding.

File Explorer

Download Latest Version (.zip)

- - chat-basic-mention-reply.png
  - chat-custom-personality-reply.png
  - chat-google-search-grounding-part-1.png
  - chat-google-search-grounding-part-2.png
- - downloads-content-sent-confirmation.png
  - downloads-message-content-link.png
  - downloads-session-conversation-link.png
- - settings-control-center.png
  - settings-custom-personality-modal.png
  - settings-server-and-channel-panels.png
  - settings-session-manager.png
- - tools-code-execution-generated-files.png
  - tools-code-execution-prompt-and-code.png
- - paths.js
  - runtime.js
- - commands.js
- - buttonHandler.js
  - commandHandler.js
  - interactionHandler.js
  - interactionHelpers.js
  - messageHandler.js
  - modalHandler.js
  - selectMenuHandler.js
- - attachmentService.js
  - codeExecutionService.js
  - conversationContext.js
  - conversationService.js
  - geminiApiLogger.js
  - scopeResolution.js
  - sessionService.js
  - streamingService.js
  - textSharingService.js
- - initializeBot.js
  - main.js
- - botState.js
  - mutex.js
  - persistence.js
  - sessionState.js
- - messageActions.js
  - settingsViews.js
- - discord.js
  - errorFormatter.js
  - errorHandler.js
  - historyRef.js
  - responseActions.js
  - sessionConstants.js
- bootstrap.js
- constants.js
.gitignore
example.env
index.js
LICENSE.md
package.json
README.md

# Installation Guide

1. Get the code

git clone https://github.com/hihumanzone/Gemini-Discord-Bot

Downloads the entire project code from GitHub to your computer.

cd Gemini-Discord-Bot

Moves into the project folder you just downloaded.

2. Node.js

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Node.js Node.js must be installed to use npm. The LTS version is recommended.

npm install

Downloads and installs the libraries listed in package.json.

npm start

Starts the development/run server.

✅ After running the command, open the address shown in the terminal (usually something like http://localhost:3000) in your browser.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Gemini Discord Bot

[![Node.js](https://img.shields.io/badge/Node.js-20%2B-3C873A?logo=node.js&logoColor=white)](https://nodejs.org/)
[![Discord.js](https://img.shields.io/badge/discord.js-14.25.1-5865F2?logo=discord&logoColor=white)](https://discord.js.org/)
[![Gemini API](https://img.shields.io/badge/Google-Gemini%20API-4285F4?logo=google&logoColor=white)](https://ai.google.dev/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://raw.githubusercontent.com/hihumanzone/Gemini-Discord-Bot/main/LICENSE.md)

AI Discord bot powered by Google Gemini with streaming responses, multimodal input, session-based memory, and rich settings UI.

For voice-channel conversations with Gemini Live API, see [Gemini-Live-discord](https://github.com/hihumanzone/Gemini-Live-discord), a Discord bot for natural voice conversations with Gemini.

## What It Does

- Chats in DMs or in servers (mention, always-respond mode, or personal active mode)
- Understands text, images, videos, audio, PDFs, and office/code files
- Supports per-user sessions plus optional channel-wide or server-wide shared memory
- Lets users toggle Gemini tools (Google Search, URL Context, Code Execution)
- Provides admin controls for moderation and server/channel behavior
- Includes **Nano Banana** mode for advanced image generation and editing capabilities
- Exports message content and full conversation history as shareable links

## Quick Start

### 1) Requirements

- Node.js 20+
- Discord bot token: https://discord.com/developers/applications
- Google Gemini API key: https://aistudio.google.com/app/apikey

### 2) Install

```bash
git clone https://github.com/hihumanzone/Gemini-Discord-Bot.git
cd Gemini-Discord-Bot
npm install
```

### 3) Configure Environment

Create a `.env` file:

```env
DISCORD_BOT_TOKEN=your_discord_bot_token
GOOGLE_API_KEY=your_google_api_key
```

### 4) Run

```bash
npm start
```

## Discord Bot Setup Checklist

Enable these intents in the Discord Developer Portal:

- Guilds
- Guild Messages
- Message Content
- Direct Messages

Recommended bot permissions:

- Send Messages
- Embed Links
- Attach Files
- Use Slash Commands
- Manage Messages

## Commands

| Command | Who can use it | Purpose |
|---|---|---|
| `/settings` | Everyone | Open personal control center |
| `/clear_memory` | Everyone | Clear active session memory |
| `/status` | Everyone | Show CPU/RAM and reset timer |
| `/channel_settings` | Admin | Configure channel behavior |
| `/server_settings` | Admin | Configure server-wide behavior |
| `/block user:@user` | Admin | Block a user in this server |
| `/unblock user:@user` | Admin | Remove user block |

Slash commands are checked on startup and auto-synced when changes are detected.

## How Memory Works

- **User sessions**: each user can maintain multiple independent conversations.
- **Channel-wide history**: one shared memory per channel.
- **Server-wide history**: one shared memory for the whole server.
- If shared history is enabled (channel/server), it overrides personal session history in that scope.

## Screenshots

### Settings UI

![Control Center](https://raw.githubusercontent.com/hihumanzone/Gemini-Discord-Bot/main/Screenshots/settings/settings-control-center.png)
![Session Manager](https://raw.githubusercontent.com/hihumanzone/Gemini-Discord-Bot/main/Screenshots/settings/settings-session-manager.png)
![Server and Channel Settings](https://raw.githubusercontent.com/hihumanzone/Gemini-Discord-Bot/main/Screenshots/settings/settings-server-and-channel-panels.png)
![Custom Personality Modal](https://raw.githubusercontent.com/hihumanzone/Gemini-Discord-Bot/main/Screenshots/settings/settings-custom-personality-modal.png)

### Chat and Responses

![Basic Mention Reply](https://raw.githubusercontent.com/hihumanzone/Gemini-Discord-Bot/main/Screenshots/chat/chat-basic-mention-reply.png)
![Custom Personality Reply](https://raw.githubusercontent.com/hihumanzone/Gemini-Discord-Bot/main/Screenshots/chat/chat-custom-personality-reply.png)

### Tooling and Grounded Responses

![Code Execution Prompt and Output Code](https://raw.githubusercontent.com/hihumanzone/Gemini-Discord-Bot/main/Screenshots/tools/tools-code-execution-prompt-and-code.png)
![Code Execution Generated Files](https://raw.githubusercontent.com/hihumanzone/Gemini-Discord-Bot/main/Screenshots/tools/tools-code-execution-generated-files.png)
![Google Search Grounding Part 1](https://raw.githubusercontent.com/hihumanzone/Gemini-Discord-Bot/main/Screenshots/chat/chat-google-search-grounding-part-1.png)
![Google Search Grounding Part 2](https://raw.githubusercontent.com/hihumanzone/Gemini-Discord-Bot/main/Screenshots/chat/chat-google-search-grounding-part-2.png)

### Downloads and Sharing

![Content Sent Confirmation](https://raw.githubusercontent.com/hihumanzone/Gemini-Discord-Bot/main/Screenshots/downloads/downloads-content-sent-confirmation.png)
![Message Content Download Link](https://raw.githubusercontent.com/hihumanzone/Gemini-Discord-Bot/main/Screenshots/downloads/downloads-message-content-link.png)
![Session Conversation Download Link](https://raw.githubusercontent.com/hihumanzone/Gemini-Discord-Bot/main/Screenshots/downloads/downloads-session-conversation-link.png)

## Configuration

Core defaults live in `config.js`:

- Default Model: `gemini-flash-lite-latest`
- Nano Banana Model: `gemini-2.5-flash-image`
- Enable Nano Banana Mode: `true`
- Max generation attempts: `3`
- Default response mode: `Embedded`
- Tool defaults: Google Search = on, URL Context = on, Code Execution = off

## Project Structure

```text
src/
  core/        runtime setup and shared paths
  handlers/    message and interaction routing
  services/    Gemini orchestration, attachments, streaming, sessions
  state/       JSON persistence, history lifecycle, locking
  ui/          Discord settings views and action buttons
  utils/       Discord and error formatting helpers
```

Runtime data is stored in `data/` and temporary files in `temp/`.

## Notes

- Keep `.env` private and never commit secrets.
- Conversation/state is persisted locally as JSON files.

## License

MIT ([LICENSE.md](LICENSE.md))