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.
- 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.
- 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.
- 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.
- 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.
- Open SillyTavern → Extensions panel (puzzle icon) → Install Extension
- Paste this repository's Git URL and click Install
- Refresh the page — done!
The companion regex is auto-injected on first load. No manual import needed.
- SillyTavern: 1.12.7+ (AI analysis requires 1.13.5+)
- Platforms: Desktop + Mobile
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 | 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.
- 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,柏柏
- Russian (Русский) — @KiskaSora
- @baibai-git — PR #5 integration contribution
