CHIM

Dwemer Dynamics Home Overview Installation Plugins Configuration Roleplay Settings Skyrim Settings Large Language Models Text-to-Speech Speech-to-Text Image-to-Text Modders Guide FAQ Remote Hosting Guide Linux Setup Guide Log Files

⬇️Download 🎥Video Guide DiscordDiscord YouTubeYouTube PatreonPatreon

CHIM Configuration

This page explains the main CHIM setup pages inside HerikaServer in plain language. Use it once your install is working and you want to tune how CHIM behaves in play.

General Settings

What this page does: This is the global behavior page for CHIM. Changes here affect the whole playthrough, not just one NPC or one profile.

  • Prompt: Sets the main instruction text CHIM follows and the mood list it can use when it formats emotional tags.
  • Rechat: Controls how tightly CHIM tries to answer the intended speaker, including whether rechat targeting stays strict or feels looser and more conversational.
  • Memory: Turns long-term memory on or off, controls whether text2vec is used, and decides how often CHIM writes fresh summaries.
  • Global Connectors: Chooses the shared AI brains used for player respeech, summaries, middle-term memory and Background Life, scene classification, dynamic profiles, director mode, relationship handling, and custom Oghma work.
  • Context: Filters what world information is sent into prompts, including event types, timestamps, and noisy item, location, or magic data you may want to trim out.
  • Prompt Context Selections: Lets you choose which buckets of character, appearance, and general context CHIM should carry into conversations.
  • Misc: Covers things like auto-locking profiles, auto-filling custom profiles, Background Life day cooldowns, end-conversation cooldowns, and focus chat history size.
  • Translation: Handles DeepL-based text and audio translation for players who want CHIM to speak across languages.

Profiles

What this page does: Profiles are reusable behavior presets for NPCs and narrator setups. Instead of configuring every character one by one, you build profile bundles and assign characters to them.

  • Basic profile setup: Each profile has a label and an optional slot from 1 to 4 so you can swap to it more easily in game.
  • Behavior defaults: Profiles can act as the default NPC or default narrator setup, and they also decide whether dynamic profile changes are allowed by default.
  • Dynamic Profile fields: You can choose whether CHIM is allowed to evolve personality, speech style, and goals for NPCs using that profile.
  • Diary options: Profiles include diary settings like auto diary and whether wait events also count for auto-diary writing.
  • Connector choices: Each profile can use its own Standard, Fast, Powerful, Experimental, Diary, and Formatter large language models, plus its own Text-to-Speech and Image-to-Text connectors.
  • Workflow tools: The page also supports cloning, exporting, importing, testing all profiles, and setting profile rules.
  • In play: NPCs using the same profile inherit the same overall behavior style, so this is the fastest way to make groups of characters feel different.

API Keys

What this page does: API Keys is the shared login page for CHIM services. You save provider keys here once, then the connector pages reuse them.

  • Preset keys: The page has built-in entries for OpenRouter, OpenAI, Deepgram, Google, Azure, and ElevenLabs.
  • Custom keys: You can also add your own named key rows for other supported services.
  • Used across CHIM: These saved keys are then selected by the Large Language Model, Text-to-Speech, Speech-to-Text, and Image-to-Text pages.
  • Quick testing: Some providers can be tested directly from this page so you can catch a bad key before troubleshooting the rest of the setup.

Playthrough Manager

What this page does: Playthrough Manager is CHIM's snapshot system for your AI database state. It is for saving, switching, and restoring full CHIM playthrough states.

  • Active Database: CHIM keeps one live database in use right now. That is the state your current conversations and systems are using.
  • Stored Snapshots: You can save named snapshots with notes so you can return to an earlier AI state later.
  • Copy to Public: Loading a snapshot replaces the live CHIM database with that saved state and first auto-saves your current live state for safety.
  • Restart required: After switching snapshots, CHIM needs to be restarted before the new state is fully active.
  • Cleanup: Old snapshots can be deleted, but the active one cannot be removed from the page.

Narration

What this page does: This page controls how The Narrator behaves, how often it speaks, and what voice and profile it uses.

  • Core narrator toggles: You can turn the narrator on or off, keep it limited to book-style narration, hide it from normal context, and decide whether it can write diary content.
  • Inline narration: This decides what happens to *asterisked* narration, including whether The Narrator voices it, the NPC keeps it, or it is disabled.
  • Cleanup options: The page also includes asterisk cleanup controls so player or NPC voices do not read action text out loud unless you want them to.
  • Welcome, random, and bored commentary: You can tune welcome lines on load, random scene comments, and bored-event narrator takeovers with chance and cooldown controls.
  • Quest comments: Lets The Narrator react to quest objective updates, again with its own chance and cooldown settings.
  • Profile and voice: You choose the narrator profile, voice ID, and Oghma knowledge tags from here.
  • Advanced narrator behavior: The page also includes narrator-specific dynamic profile options, narrator action toggles, and narrator prompt overrides.

Player Roleplay

What this page does: This page is your player character sheet for CHIM. It tells the system who your character is, how they sound, and what information CHIM should track about them.

  • Identity: You can define the player name, physical description, and character background so NPCs have a stable idea of who you are.
  • Bio visibility: A simple toggle decides whether all NPCs know your background or whether that knowledge stays mainly with The Narrator.
  • Speech style: You can write your own player speech style or generate one so CHIM better preserves your character voice during roleplay.
  • Diary and Player TTS: The page includes player diary participation plus a dedicated player voice path with connector, voice, language, and provider-specific overrides.
  • Live tracked data: It also shows and stores current equipment, inventory, skills, and grouped Skyrim stats so the roleplay stays grounded in your actual playthrough.

Action Editor

What this page does: Action Editor controls which gameplay actions CHIM is allowed to use and where those actions are allowed to appear.

  • Enabled state: You can turn individual actions on or off without editing the shipped base action list.
  • Scope: Actions can be available to normal NPCs, followers, The Narrator, or only as background dynamic actions.
  • Visible action text: Each action row includes the action name, description, and return message CHIM uses to understand and react to that action.
  • Parameters: Actions can also carry parameter definitions, which is how more complex actions know what values they expect.
  • Advanced fields: Metadata, script proxy information, and pricing controls are there for deeper tuning, but most normal users will rarely touch them.
  • Filtering: The page includes live search and scope filters so you can quickly find the exact action you need.

Prompts Manager

What this page does: Prompts Manager is the page for editing CHIM's built-in prompt text one prompt at a time.

  • Prompt browsing: The table is searchable by prompt key, description, status, and preview text.
  • Default versus custom: Each row shows the shipped default prompt and any custom replacement you have added.
  • Edit and clear: You can override only the prompts you care about, or clear a custom prompt to instantly fall back to the default.
  • Import and export: Custom prompt changes can be exported or imported as CSV for backup or sharing.