BragiBytes

# Loreweave

**Fantasy names for writers and dungeon masters.**

A simple, controllable tool that generates authentic-sounding fantasy names, places, spells, and words. Built specifically for fiction authors, worldbuilders, and tabletop game masters (D&D, Pathfinder, etc.).

No black boxes. No sign-ups. You control the data.

## Why this exists

Coming up with 50 good elf names that don’t all sound the same is surprisingly difficult. Same problem with orc warlords, ancient dragons, cursed cities, or magical academies.

Loreweave combines a high-quality traditional generator with an optional experimental neural network. The traditional generator gives excellent, varied results immediately. The neural version (use `--ai`) is there for tinkerers who want to play with a tiny model they can fully understand and retrain.

## Quick Start

```bash
# Install
pip install -e .

# Generate fantasy names
loreweave new

# Elven style
loreweave new --style elven --count 15

# Dark fantasy with a starting sound
loreweave new --style dark --prompt "mor" --count 10

# See all available styles
loreweave styles
```

## Available Styles

| Style     | Feels like                          | Example output          |
|-----------|-------------------------------------|-------------------------|
| `elven`   | Graceful, melodic, ancient          | Aeloria, Thalor, Lirael |
| `dwarven` | Sturdy, consonant-heavy, clan-like  | Thrain, Borin, Grimnir  |
| `dark`    | Ominous, villainous, gothic         | Malachar, Vorgath, Sable|
| `arcane`  | Magical, celestial, mysterious      | Velarion, Mystara, Aether |
| `places`  | Cities, forests, mountains, ruins   | Silverwood, Dragonspine |
| `orcish`  | Brutal, harsh, warlike              | Grommash, Bloodfist     |

You can also just run `loreweave new` with no style for a nice mix.

## How to use it as a writer or DM

- Stuck on a side character? `loreweave new --style dark --count 8`
- Building an elven kingdom? `loreweave new --style elven --prompt "ael"`
- Need 30 tavern names fast? Use `--style places`
- Want names that start with specific letters? Use `--prompt "th"` or `--prompt "z"`

## Philosophy

- Small and understandable (you can read the whole model)
- You own the training data
- Fast enough to experiment constantly
- Made for creative people who need *names*, not essays

## Status

This project was originally a general experiment in building a tiny neural net from scratch. It has now been repurposed into a practical tool for fiction and tabletop storytelling.

More styles, better generation, and the ability to train on your own name lists are planned.

---

*For writers who need good names without the noise.*