SillyTavern-Pathweaver/README.md
2026-02-07 10:06:17 -05:00

11 KiB

🧭 Pathweaver for SillyTavern

Elevate your stories and roleplays from good to unforgettable. Pathweaver injects fresh ideas, unexpected twists, and genre-perfect moments exactly when you need them, making every session feel like a professionally crafted story.

🆕 What's New

ver 1.1

  • You can now enable streaming in settings, which streams the suggestions to each card one at a time rather than waiting for all of them to be filled. Works with Ollama, OpenAI-compatible endpoints, and any Connection Profile/Main API that supports streaming
  • Setting to change the font of the title 'Pathweaver' on the bar, or even hide it
  • Misc. bug fixes some users pointed out

ver 1.0.5

  • Insert Type: optional feature to copy/insert/send suggestions inside either [OOC: ] or [Director: ]
  • Added a field for custom OpenAI-compatible endpoints that require an API key

Version License GitHub stars GitHub issues

Pathweaver is a creative companion extension for SillyTavern. It analyzes your current chat context and generates Suggestions — options for where the story could go next. Whether you need a sudden plot twist, a new character introduction, or just a little nudge to break writer's block, Pathweaver provides up to 6 distinctive suggestions for every request.

Pathweaver
The Pathweaver bar - Director Mode, Context-Aware, Plot Twist, New Character, Explicit, Custom, and Genre suggestions.


Key Features

🎯 Smart Generation

  • Context-Aware: Analyzes 2-10 messages for coherent suggestions
  • Director Mode: Single Scene or Story Beats for precise control
  • Genre Specialization: 9 built-in genres + unlimited custom styles

⚙️ Flexible & Powerful

  • Multiple Backends: Main API, Connection Profiles, Ollama, OpenAI-compatible
  • Responsive Design: Works on desktop, tablets, and smartphones
  • Seamless Integration: Glass UI design matches SillyTavern perfectly

Pathweaver - Settings
Each card with option to Copy (copies to clipboard), Insert (add to SillyTavern's input but doesn't send) or Send (immediately sends to the AI.)


🎮 How It Works

Pathweaver adds a Control Bar above your chat input. Click any button to instantly generate up to 6 suggestions.

The Categories

Icon Category Usage
🎬 Director Opens a simplified input box. You type a prompt, AI gives you tailored suggestions.
🧭 Context-Aware "What happens next?" Smart suggestions based on story logic and context.
🔀 Plot Twist Throws a curveball. Unexpected events, betrayals, and shocks.
👤+ New Character Adds a new character to the story based on a variety of character tropes.
🔥 Explicit (Optional) NSFW Spicy suggestions. Only one hand needed.
🎭 Genres A dropdown menu with specific genre flavors: Horror, Romance, Sci-Fi, etc.
📚 Custom Create custom suggestions, such as genre mashups like "Cyberpunk-Noir" or "Cozy-Horror".

Pathweaver - Director Mode
Direct your next scene with Single Scene or Story Beat modes.


🛠️ Installation

  1. Open SillyTavern and click the Extensions button (puzzle piece icon)
  2. Select Install Extension
  3. Paste this URL:
    https://github.com/mattjaybe/SillyTavern-Pathweaver
    
  4. Click Install and refresh SillyTavern

🚀 Quick Start

  1. Install the extension (see Installation above)
  2. Refresh SillyTavern - You'll see the Pathweaver bar appear above your chat input
  3. Start a conversation with any character
  4. Click any button on the bar (try 🧭 Context-Aware first!)
  5. Pick a suggestion and watch your story unfold

That's it! Pathweaver works with your existing API setup - no additional configuration needed.


⚙️ Configuration

Access Pathweaver settings by clicking the ⚙️ gear icon on the right side of the Pathweaver bar or in SillyTavern's extension menu.

Generation Engine

Engine Description
Main (API) Uses your currently active SillyTavern API. Easiest setup.
Connection Profile Recommended. Select a Connection Profile saved in SillyTavern.
Ollama Connect directly to a local Ollama instance (default: http://127.0.0.1:11434).
OpenAI Compatible Connect to KoboldCPP, LM Studio, vLLM, or other OpenAI-compatible endpoints.

Settings

  • Show Explicit: Toggle the visibility of the "Explicit" (Fire icon) category.
  • Button Size: Compact, Default, or Max.
  • Font Size: Adjust the size of the text from Small, Default, or Large.
  • Title Font: Change the font of 'Pathweaver' on the bar, or hide it altogether.
  • Stream Suggestions: Cards appear in real-time as each suggestion is generated.
  • Minimal Mode: Arrow on the bar hides and shows Pathweaver.

Pathweaver - Settings
Quickly and easily adjust the Pathweaver settings to your preferences.


EchoChamber

Be sure to check out my other extension for SillyTavern: EchoChamber.

EchoChamber is a powerful extension that generates a live reaction feed alongside your story. Whether it's a salt-fueled Discord chat, a viral Twitter feed, dramatic breaking news, or a sarcastic MST3K roasting session—EchoChamber immerses you in the world with AI-generated audience reactions.

Pathweaver - Settings
Quickly and easily adjust the Pathweaver settings to your preferences.


🌟 Extras

🎨 EyeCare Theme

The screenshots use a custom high-contrast theme optimized for readability. Copy the JSON below and save as a .json file to import into SillyTavern:

Click to view Theme JSON
{
    "name": "EyeCare",
    "blur_strength": 0,
    "main_text_color": "rgba(230, 240, 255, 1)",
    "italics_text_color": "rgba(150, 220, 255, 1)",
    "underline_text_color": "rgba(255, 200, 100, 1)",
    "quote_text_color": "rgba(180, 255, 180, 1)",
    "blur_tint_color": "rgba(15, 20, 28, 1)",
    "chat_tint_color": "rgba(15, 20, 28, 1)",
    "user_mes_blur_tint_color": "rgba(22, 28, 38, 1)",
    "bot_mes_blur_tint_color": "rgba(18, 24, 32, 1)",
    "shadow_color": "rgba(0, 0, 0, 1)",
    "shadow_width": 0,
    "border_color": "rgba(70, 100, 140, 1)",
    "font_scale": 1,
    "fast_ui_mode": true,
    "waifuMode": false,
    "avatar_style": 2,
    "chat_display": 1,
    "toastr_position": "toast-top-right",
    "noShadows": true,
    "chat_width": 50,
    "timer_enabled": false,
    "timestamps_enabled": true,
    "timestamp_model_icon": true,
    "mesIDDisplay_enabled": false,
    "hideChatAvatars_enabled": false,
    "message_token_count_enabled": false,
    "expand_message_actions": true,
    "enableZenSliders": false,
    "enableLabMode": false,
    "hotswap_enabled": false,
    "custom_css": "",
    "bogus_folders": false,
    "zoomed_avatar_magnification": false,
    "reduced_motion": true,
    "compact_input_area": false,
    "show_swipe_num_all_messages": false,
    "click_to_edit": false,
    "media_display": "list"
}

Explore Pathweaver with the custom-made Real Talk Podcast story:

Real Talk Podcast Card

Right-click & Save to import

The Story:
Victoria Cross, 38, built her podcast empire dissecting male mediocrity and modern dating's failures—until Daniel, 18, calls in and systematically dismantles her worldview on air. Their explosive debates accidentally spark the "New Pond Movement," urging older women to pursue younger men and leave the "stagnant pond" behind.

Import Options:


🤝 Contributing

Love Pathweaver? Here's how you can help:

  • Star this repo to show support
  • 🐛 Report bugs via Issues
  • 💡 Request features you'd love to see
  • 🎨 Share custom styles with the community (Discussion)
  • 🔧 Submit PRs for improvements
  • 📣 Spread the word and tell your friends about Pathweaver

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.


Made with ❤️ for the SillyTavern community