Gemini-Discord-Bot

KO | EN

gitlite — search

#typescript #ai-agents #deepseek-harness #dsh-plugin #open-source #ai #claude-code #cli #windows #codex #developer-tools #dsh

Gemini-Discord-Bot

★ 98 Open GitHub ↗

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

// 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))

Gemini-Discord-Bot

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README