What one reply looks like

PartWhat you see
ReasoningFolded. Click to read how Lumi planned the scene.
StoryThe prose itself, in your chat as usual.
ChoicesThree next moves. Click one to put it in your message box.
RecapFolded one-line summary of what just happened.
NoteA short aside from Lumi to you.

1. Install the extension

  1. In SillyTavern, open Extensions (the puzzle-piece icon at the top).
  2. Click Install extension.
  3. Paste the address below and click Install.
  4. Reload the page.
text
https://github.com/tavernapi/sillytavern-lumi

You will find TavernAPI Preset Runtime in the Extensions panel. Updates come through Manage extensions → Update.

2. Import the preset

Download TavernAPI_StoryEngine.json
  1. Download TavernAPI_StoryEngine.json with the button above.
  2. Open AI Response Configuration (the sliders icon, top left).
  3. Click the Import preset icon next to the preset dropdown and pick the file.
  4. Select TavernAPI_StoryEngine in the dropdown.

The preset already sets temperature, length and streaming. You don't need to change any sliders.

3. Connect a Gemini model

Open API Connections (the plug icon) and set API to Chat Completion. Then pick one:

With TavernAPI

FieldValue
Chat Completion SourceCustom (OpenAI-compatible)
Custom Endpoint (Base URL)https://tavernapi.com/v1
Custom API Keyyour key from the TavernAPI console
Modelgemini-4-argon (best) or gemini-3.8-flash (cheaper)

With your own Google key

Choose Google AI Studio (or Google Vertex AI) as the source, paste your key and pick a Gemini model.

Click Connect.

4. Two switches to check

  • AI Response Configuration → Enable function calling must be on. Lumi writes her replies through it.
  • API Connections → Prompt Post-Processing should be None.

If either is wrong, the extension shows a red notice in its settings.

5. Check that it works

Open Extensions → TavernAPI Preset Runtime. The status next to the title should say Connected (or Ready). Start a chat and send a message: the reply should arrive with the panels above. Lumi thinks before she writes, so the first reply can take a minute.

Make it yours

Everything in the preset list is a switch. Entries with a 🔒 have fixed text, but you can still turn them off.

You wantDo this
Longer repliesTurn on 📝 Word count.
No recapTurn off 🔒 Recap. Older turns are then sent in full.
Lumi stops speaking for youTurn on ⚙️ No puppeting me.
Clicking a choice sends it at onceExtensions → TavernAPI Preset Runtime → Choice click: Send.
Light panels on a light themePanel theme: Auto follows your chat theme; Dark or Light forces one.

Mature content is off by default. The ❤️ entries turn it on, and the 📖 Read me first entry in the preset explains the rules.

Troubleshooting

What happensFix
The reply is one block of text, no panelsThe extension is off, or Advanced → Runtime is off in its settings.
No reasoning or choicesEnable function calling is off.
Status says OfflineThe extension can't reach tavernapi.com. It keeps working with its saved copy; check your connection and click ↻.
Replies are shortTurn on 📝 Word count, or raise Max response length.
An error mentioning toolsYour model or source doesn't support function calling. Use a Gemini model.