Skip to content
 
 

Latest commit

 

History

259 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Horae v1.12.7 - Memory Engine for SillyTavern

English | 简体中文 | 繁體中文

Image

Horae — Greek goddesses who governed the orderly progression of time

Long-form RP players know the pain: AI memory is basically a goldfish. Yesterday's events become "this morning," costumes change between paragraphs, NPC relationships flip, gifted items vanish, and discarded ones reappear.

Horae gives your AI a reliable memory ledger using structured time anchors.


Features

Core Memory System

  • Timeline Tracking — Events are timestamped with relative time calculations ("yesterday", "last Wednesday", "2 months ago"). AI finally knows the difference.
  • Costume Lock — Each character's current outfit is recorded and only sent for present characters. No more phantom wardrobe changes.
  • NPC Tracking — Appearance, personality, relationships tracked independently. Ages advance with story time. Relationship prompts are strictly enforced.
  • Item Inventory — Unique ID system with Normal / Important / Critical tiers. Smart quantity parsing, auto-detection of consumed items.
  • Agenda — AI automatically records plot promises and deadlines. Completed items are auto-removed.
  • Mood & Relationships — Emotion tracking keeps characters consistent. Relationship network records bonds between characters. Both are change-driven: zero output when nothing changes.
  • Scene Memory — Records fixed physical features of locations for consistent descriptions across visits.

RPG System (Modular)

  • Status Bars — HP/MP/SP with custom names, colors. Dozens of status effect icons.
  • Attribute Panel — Multi-dimensional stats (STR/DEX/CON/INT/WIS/CHA) with radar chart.
  • Skills — Track skill ownership, levels, and descriptions.
  • Equipment — Per-character slot configs with 6 racial templates (Human, Orc, Centaur, Lamia, Winged, Demon). Custom templates supported.
  • Reputation — Custom faction categories with sub-dimensions.
  • Level / XP — Experience formula with visual progress bars.
  • Currency — Custom denominations with emoji icons and exchange rates.
  • Strongholds — Tree-structured base/territory management.
  • All modules are independently toggleable. Disabled = zero token cost.

Smart Token Management

  • Auto Summary & Hide — Automatically compresses old messages into AI-generated summaries. Original messages are /hided to save tokens. Summaries can be toggled back to original events anytime.
  • Vector Memory — Semantic search engine that recalls hidden details when conversation touches historical events. Runs locally via Web Worker — zero API cost.
  • AI Batch Scan — One-click retroactive analysis of entire chat history.
  • Change-Driven Output — AI only outputs what changed this turn. No redundant state dumps.

User Experience

  • Custom Tables — Excel-style tables with AI auto-fill, row/column locking, undo/redo.
  • Theme Designer — Visual theme editor with hue/saturation sliders, image decorations, day/night modes. Export & share themes as JSON.
  • Interactive Tutorial — First-time users get a guided walkthrough of all features.
  • Custom Prompts — Full control over main API body injection, sub-API body injection, batch scan, compression, and RPG prompts. Preset save/load system.
  • Config Profiles — Export all settings as a JSON file. Card authors can share configs for one-click setup.

Installation

  1. Open SillyTavern → Extensions panel (puzzle icon) → Install Extension
  2. Paste this repository's Git URL and click Install
  3. Refresh the page — done!

The companion regex is auto-injected on first load. No manual import needed.


Compatibility

  • SillyTavern: 1.12.7+ (AI analysis requires 1.13.5+)
  • Platforms: Desktop + Mobile

Public API (for other extensions / presets)

After Horae loads, a read-only API is available at window.Horae:

// Check if Horae is installed and enabled
window.Horae?.isEnabled()        // → true / false

// Read current world state (time, location, characters, costumes, items, mood, npcs…)
window.Horae?.getLatestState()   // → state object

// Read timeline events
window.Horae?.getEvents(10)      // → last 10 events

// Read settings (shallow copy)
window.Horae?.getSettings()

// Version string
window.Horae?.version            // → "1.12.7"

Settings change events are broadcast via SillyTavern's eventSource:

eventSource.on('horae:settingsChanged', (data) => {
    console.log('Horae enabled:', data.enabled);
});

All methods are read-only. No write operations are exposed.


Language Support

Language Status
简体中文 (Simplified Chinese) ✅ Full
繁體中文 (Traditional Chinese) ✅ Full
English ✅ Full
한국어 (Korean) ✅ Full
日本語 (Japanese) ✅ Full
Русский (Russian) ✅ Full

Want Horae in your language? Open an Issue or submit a PR with a translation file! See locales/en.json for the translation template.


What's New in v1.11.0

Internationalization (i18n)

  • UI Language Selector — Switch between Simplified Chinese, Traditional Chinese, English, Korean, Japanese, and Russian. Auto-detect option available.
  • AI Output Language — Separate setting for AI response language, independent of UI language.
  • 900+ translated keys — All UI text, prompts, tooltips, and tutorials are fully translated.
  • Simplified/Traditional Chinese bidirectional parsing — No more search/parse failures due to character variant differences.

See CHANGELOG for full version history.


Bug reports and suggestions are welcome!

⚠️ This is a side project — replies may be delayed. Thank you for your patience.

Author: SenriYuki,柏柏

Translation Credits

Credits

About

SillyTavern 记忆增强插件 / Memory enhancement extension for SillyTavern

Resources

Stars

6 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages