spongebob-vocab/README.md
BarnacleBoy d97e28467d Initial commit: SpongeBob vocabulary transformer plugin
- Random opening interjections (25% chance, configurable)- Pattern-based vocabulary replacement (Wow! → Tartar sauce!)
- Preserves code blocks, URLs, file paths
- Zero-token post-processing via transform_llm_output hook
2026-05-09 20:52:57 +00:00

80 lines
No EOL
2 KiB
Markdown

# spongebob-vocab
SpongeBob vocabulary transformer plugin for Hermes Agent. AddsBarnacleBoy personality through zero-token `transform_llm_output` hooks.
## What it does
1. **Random opening interjections** - 25% chance to prepend phrases like "Jumping jellyfish!" or "Tartar sauce!" at the start of responses
2. **Pattern-based vocabulary replacement** - Transforms words like "Wow!" → "Tartar sauce!", "Amazing!" → "Holy Krabby Patties!"
3. **Preserves technical content** - Code blocks, URLs, file paths, and shell commands are never modified
## Installation
Copy to your Hermes plugins directory:
```bash
cp -r spongebob-vocab ~/.hermes/plugins/
```
## Activation
Set the environment variable:
```bash
export SPONGEBOB_MODE=on
```
Or add to your shell config:
```bash
echo 'export SPONGEBOB_MODE=on' >> ~/.bashrc
```
## Configuration
| Variable | Default | Description |
|----------|---------|-------------|
| `SPONGEBOB_MODE` | `off` | Set to `on`, `1`, `true`, or `yes` to enable |
| `SPONGEBOB_INTERJECTION_CHANCE` | `0.25` | Probability (0.0-1.0) of adding opening interjection |
## Opening Interjections
Randomly selected from:
- Jumping jellyfish!
- Tartar sauce!
- Barnacles!
- Holy Krabby Patties!
- Great Neptune's nostrils!
- Mother of Pearl!
- Flappin' flounders!
- Holy fish paste!
- Holy shrimp!
- Great Barrier Reef!
- Aw, fish paste!
- Holy cephalopod!
- What the barnacle!
## Vocabulary Patterns
| Original | SpongeBob |
|----------|-----------|
| Wow! | Tartar sauce! |
| Amazing! | Holy Krabby Patties! |
| Excellent! | Holy fish paste! |
| Perfect! | Holy cephalopod! |
| Fantastic! | Holy shrimp! |
| Brilliant! | Great Barrier Reef! |
| Damn! | Barnacles! |
| Ugh! | Fish paste! |
## Technical Details
- Uses `transform_llm_output` hook - runs after LLM generation
- Zero additional inference tokens (post-processing only)
- Preserves code blocks, inline code, URLs, file paths, shell commands
- Anti-double-interjection: won't add if response already starts with an interjection
## License
MIT