---
url: https://lettuceai.app/docs/group-chats
title: "Group Chats — LettuceAI"
description: "Chat with multiple AI characters at once with automatic or manual speaker selection and structured roleplay."
---

Menu 

# Group Chats

Group Chats let you talk to multiple characters in a single conversation. Choose at least two characters and run the group as a casual conversation or a structured roleplay.

![Group chats list screen](https://lhdgeo5fms.ufs.sh/f/m0TBUtMLsaiElCO2St7C73dLiJV9kSZtR4oG2cbhwPzgNanQ)

## Create a group

Open the **+** menu and pick **Group Chat**. Select at least two characters, then give the group a name and optional background.

-   **Conversation**: freeform multi-character chat
-   **Roleplay**: structured scenes with a starting setup

Group chats are stored as their own sessions and appear in the Group Chats list alongside a history view for older sessions.

![Group chat starting scene setup](https://lhdgeo5fms.ufs.sh/f/m0TBUtMLsaiExLtx9yUkw2MN5G1QtVTFbq6Audpci7RZUDXS)

## Starting scenes (roleplay)

If you choose roleplay, you can start with a custom scene or re-use a scene from one of the selected characters. This sets the tone before the chat begins.

![Group chat message view](https://lhdgeo5fms.ufs.sh/f/m0TBUtMLsaiE7NJlCdS3XDOMPNhgrUjbZp9fWTYnCuB0v4wx)

## During the chat

Each message is labeled by character so you can track who is speaking. You can also cancel a response at any time using the abort controls.

Group chat message cards are optimized for readability and longer sessions.

## Group settings

The Group Settings page lets you edit the group name, manage members, update the background image, and choose a persona for the conversation.

![Group chat settings screen](https://lhdgeo5fms.ufs.sh/f/m0TBUtMLsaiEPKwYHeQmcHWF6TyX3N5xaVrkuSGLnlRKZv81)

## Personas in group chats

Personas still represent _you_ in the conversation. Selecting a persona in Group Settings changes your role across the entire group session without changing the characters themselves.

## How speaker selection works

When you send a message, the app decides which character should reply next using a clear priority order:

1.  **@mentions** always win and force a specific character.
2.  The configured **speaker selection method** for the group runs next.
3.  A **heuristic fallback** kicks in if the chosen method fails or returns a muted character.

Each group session stores its own speaker selection method. You can switch between three options at any time from group settings:

-   **LLM** (default): an LLM tool call picks the next speaker based on the recent messages and participant descriptions.
-   **Heuristic**: a local scoring pass picks a speaker without calling any model. Fast and offline-friendly.
-   **Round robin**: the next speaker is chosen by rotating through the participants, so everyone gets a turn.

![Group chat speaker selection flow](https://lhdgeo5fms.ufs.sh/f/m0TBUtMLsaiEDvEcN4Lk6KQEIaUv3RMC80pwfLYbPBhuTci9)

Speaker selection flow: mention, automatic selection, fallback, then response.

### @mentions

You can target a character directly by mentioning them:

-   `@Name` for single-word names
-   `@"Character Name"` for names with spaces

Mentions are case-insensitive and the first valid mention wins.

### LLM selection model

The selection step uses the first configured model in your settings (not the character’s own model). It reviews recent messages, participant descriptions, and participation balance, then picks the next speaker with a tool call.

### Heuristic fallback

If LLM selection fails, a local fallback scores characters based on:

-   Participation balance (who has spoken less)
-   Recency (soft penalty for very recent speakers)
-   Name mentions inside the user message

## Muting participants

You can mute individual characters in a group. Muted characters are excluded from automatic speaker selection and are skipped by the LLM, heuristic, and round robin paths. If auto-selection ever lands on a muted character, the app falls back to the heuristic to pick someone else.

Muting does not remove a character from the group. You can still target a muted character directly with an @mention to force them to reply.

## Lorebooks in groups

Group sessions can attach their own lorebooks separately from each participant. There is also a toggle to disable the per-character lorebooks entirely, so only the group-level lorebooks are active. This is useful when characters come from different worlds and you want one shared canon for the group only.

## Memory in group chats

Each group session has its own memory mode (Manual or Dynamic), chosen independently of any single character's memory setting. The dynamic memory pipeline (summary window, retrieval, decay, hot/cold split, and background maintenance cycle) is implemented in parallel with the direct-chat pipeline and uses the same settings. See the [Memory System](/docs/memory) doc for details.

Tips

Group chats work best when characters have distinct voices and clear roles. Keep prompts short and let their personalities do the work.

[

PreviousPersonas

](/docs/personas)[

NextDiscovery

](/docs/discovery)