AI & Gemini Chat

Deep dive into Kythia's intelligent conversation engine — personality tuning, persistent memory, and multi-language translation.

Kythia's AI system is powered by Google's Gemini models, bringing intelligent, context-aware conversations directly to your Discord server. Unlike simple chatbots, Kythia remembers things about each user, adapts its tone, and can translate messages in real time.

How It Works

When a user sends a message in any AI-enabled channel, Kythia:

Retrieves the user's conversation history (up to the configured length).
Applies their chosen personality style (or the server's default).
Injects any saved personal facts about the user as context.
Sends the full prompt to Gemini and streams back the response.

The AI reads every message in the channel automatically — no prefix or slash command needed.

You can configure multiple geminiApiKeys in your .env file. Kythia load-balances across all of them, preventing rate-limit errors on busy servers.

Channel Management

Enabling AI in a Channel

By default, the AI doesn't respond anywhere. You must explicitly enable it per-channel.

/ai enable channel: #your-channel

Disabling AI in a Channel

/ai disable channel: #your-channel

Command	Permission Required	Effect
`/ai enable`	`Manage Channels`	Activates AI responses in the channel
`/ai disable`	`Manage Channels`	Deactivates AI responses in the channel

AI channels are stored per-server. Admins can run /ai list to see every channel where the AI is currently active.

Viewing All Active Channels

/ai list

Returns a paginated list of every channel in the server where AI is enabled.

Personality Styles

Every user can customize how the AI speaks to them. This is stored per-user across all servers.

/ai personality style: <choice>

Style	Description
Default	Follows the server-owner's `personaPrompt` in `kythia.config.js`
Friendly	Warm, casual, and approachable. Uses empathetic, encouraging language
Professional	Formal and to the point. Proper grammar, business-like tone
Humorous	Witty and playful. Makes conversations entertaining
Technical	Detailed and precise. Provides in-depth information and explanations
Casual	Relaxed and laid-back. Informal language, "chill" vibes

Set your style to Default at any time to go back to the server owner's configured persona.

Memory & Persistent Facts

Kythia's AI has a unique long-term memory system. As you chat, the AI can save specific details you mention (your name, preferences, background, etc.) and recall them in future conversations — even weeks later.

Viewing Your Saved Facts

/ai facts

Opens a paginated, interactive view of everything the AI has learned about you. Facts are grouped by category. Navigate using the First / Prev / Next / Last buttons.

Deleting a Specific Fact

/ai fact-delete number: <fact-number>

Use the number shown in your /ai facts list to permanently remove that memory.

Deleted facts cannot be recovered. The AI will not remember the information in future conversations unless you tell it again.

Clearing All Facts

/ai forget

Wipes all saved facts for your account. Use this for a clean slate with the AI.

AI Help Command

/ai help

Displays an in-Discord guide explaining how to interact with the AI, what it can do, and how memory works. Great for sharing with new server members.

Translation

The /translate command is powered by the same AI backbone but is available in all channels — no setup needed.

/translate text: <your text> target_language: <language>

Option	Type	Required	Description
`text`	String	✅	The text you want to translate
`target_language`	String	✅	Target language (e.g., `English`, `Japanese`, `Indonesian`)

You can translate to/from any language that Gemini supports — which covers virtually all major world languages.

Admin Configuration

Configure the AI addon in kythia.config.js:

ai: {
  active: true,
  model: 'gemini-2.0-flash',          // Gemini model to use
  personaPrompt: 'You are Kythia...',  // The bot's base "personality"
  getMessageHistoryLength: 10,         // How many previous messages to remember per session
  additionalCommandKeywords: ['kythia', 'ai', 'bot', 'latency', 'latensi'],
},

The personaPrompt is the "system instruction" injected at the top of every conversation. You can make the bot roleplay as a custom character, follow specific rules, or speak in any language you want.