Files
talemate/docs/getting-started/connect-a-client.md
veguAI d0ebe95ca6 0.35.0 (#242)
Major features:
- Autonomous scene direction via director agent (replaces auto-direct)
- Inline image display in scene feed
- Character visuals tab for portrait/cover image management
- Character message avatars with dynamic portrait selection
- Pocket TTS and llama.cpp client support
- Message appearance overhaul with configurable markdown display

Improvements:
- KoboldCpp: adaptive-p, min-p, presence/frequency penalty support
- Setup wizard for initial configuration
- Director chat action toggles
- Visual agent: resolution presets, prompt revision, auto-analysis
- Experimental concurrent requests for hosted LLM clients
- Node editor alignment shortcuts (X/Y) and color picker

Bugfixes:
- Empty response retry loop
- Client system prompt display
- Character detail pins loading
- ComfyUI workflow charset encoding
- Various layout and state issues

Breaking: Removed INSTRUCTOR embeddings
2026-01-27 10:22:41 +02:00

3.4 KiB

Connect a client

!!! note "First time setup?" If this is your first time launching Talemate, the Setup Wizard will guide you through adding your first client and configuring essential settings. This page covers manual client configuration for adding additional clients or if you skipped the wizard.

Once Talemate is up and running and you are connected, you will see a notification in the corner instructing you to configured a client.

no clients

Talemate uses client(s) to connect to local or remote AI text generation APIs like koboldcpp, text-generation-webui or OpenAI.

Add a new client

On the right hand side click the :material-plus-box: ADD CLIENT button.

connect a client add client

!!! note "No button?" If there is no button, you may need to toggle the client options by clicking this button

![open clients](/talemate/img/0.26.0/open-clients.png)

The client configuration window will appear. Here you can choose the type of client you want to add.

connect a client add client modal

Choose an API / Client Type

We have support for multiple local and remote APIs. You can choose to use one or more of them.

!!! note "Local vs remote" A local API runs on your machine, while a remote API runs on a server somewhere else.

Select the API you want to use and click through to follow the instructions to configure a client for it:

Remote APIs
Local APIs
Unofficial OpenAI API implementations

Assign the client to the agents

Whenever you add your first client, Talemate will automatically assign it to all agents. Once the client is configured and assigned, all agents should have a green dot next to them. (Or grey if the agent is currently disabled)

Connect a client assigned

You can tell the client is assigned to the agent by checking the tag beneath the agent name, which will contain the client name if it is assigned.

Agent has client assigned

Its not assigned!

If for some reason the client is not assigned to the agent, you can manually assign it to all agents by clicking the :material-transit-connection-variant: Assign to all agents button.

Connect a client assign to all agents