Files
talemate/docs/getting-started/connect-a-client.md
veguAI 0e27e87e72 New client type: Pi Bridge (#97) (#99)
* feat: Pi Bridge client - drive generations through the pi coding agent RPC mode (#97)

* fix: pi bridge - refresh pi model catalog on config save so models.json changes appear without restart

* fix: pi bridge - raise subprocess stream limit so oversized RPC event lines (long thinking blocks) do not fail generation

* docs: pi bridge - note that thinking budgets are provider-enforced and may be advisory

* fix: pi bridge - address PR review (surface pi error text in dialog, drain stderr to avoid deadlock, drop dead get_model_name, docs concurrency list)
2026-07-18 19:38:40 +03:00

3.5 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