Model Overview
Model Features
Model Capabilities
Use Cases
🚀 Lucid: AI Language Models
Lucid is a family of AI language models developed and used by DreamGen, with a focus on role-play and story-writing capabilities. It offers a unique experience for writers and role-play enthusiasts, enabling them to create rich and engaging narratives.

📚 Table of Contents
- Why Lucid
- Prompt Template
- Role-Play & Story-Writing
- Sampling Params
- SillyTavern
- DreamGen Web App (free)
- Model Training Details
✨ Why Lucid
Is Lucid the right model for you? I'm not sure, but here's what I do know:
- Role-play & Story-writing Focus:
- Suitable for All Types of Users: Whether you're a world-builder who likes to plan every detail in advance (plot, setting, writing style, etc.) or an intuitive writer who starts with a loose prompt and shapes the narrative as it unfolds, Lucid has you covered.
- Multi-character Role-plays: The model can automatically switch between characters, enhancing the realism of your role-plays.
- Inline Writing Instructions (OOC): You can control plot development, pacing, and more by using inline instructions.
- Inline Writing Assistance: Get help with planning the next scene, suggesting new characters, and other writing tasks.
- Reasoning Support (Opt-in): Lucid offers optional reasoning capabilities, which can be useful for certain types of tasks.
- Detailed Documentation: The README.md provides comprehensive documentation, examples, and configs to help you get started.
If this sounds interesting, keep reading!
📝 Prompt Template
The Lucid prompt template is an extension of the Llama 3 template, with the following enhancements:
Writing
- New
writer
Role: The template adds awriter
role, which is used for writing the story or role-play. - Message Headers:
- Story-writing: The
writer
message header is<|start_header_id|>writer<|end_header_id|>
. - Role-playing:
- Character Messages:
<|start_header_id|>writer character {{character_name}}<|end_header_id|>
, where{{character_name}}
is the actual character name. - Narrator Messages:
<|start_header_id|>writer narrative<|end_header_id|>
. - The model can generate multiple messages at once and automatically select the appropriate character or narrative.
- Character Messages:
- Story-writing: The
Reasoning
- New Tokens: The template adds two new tokens for reasoning:
<|reasoning_start|>
and<|reasoning_end|>
. - Opt-in Reasoning: To enable reasoning, add
Think deeply before answering.
(or a similar prompt) to your system or user prompt.
Examples
Assistant: Simple
<|start_header_id|>system<|end_header_id|>
You are a reliable, general-purpose AI assistant.<|eot_id|><|start_header_id|>user<|end_header_id|>
Why is the sky blue?<|eot_id|><|start_header_id|>assistant<|end_header_id|>
The sky appears blue due to a phenomenon called **Rayleigh scattering**, a type of light scattering caused by tiny particles in the atmosphere. Here's a simplified breakdown:
...
Assistant: Reasoning
Note that reasoning is mainly intended for assistant tasks (knowledge, math, coding, etc.) and is less useful for writing. Smaller Lucid models (<=12B) can produce plausible reasoning traces, but the improvement in performance is not as significant as in larger models.
<|start_header_id|>system<|end_header_id|>
You are a reliable, general-purpose AI assistant.<|eot_id|><|start_header_id|>user<|end_header_id|>
Why is the sky blue?
Think deeply before answering.<|eot_id|><|start_header_id|>assistant<|end_header_id|>
<|reasoning_start|>Okay, so I need to figure out why the sky is blue. Let me start by recalling what I know...
...<|reasoning_end|>The sky appears blue due to a phenomenon called **Rayleigh scattering**. Here's a concise breakdown:
...
🎭 Role-Play & Story-Writing
Here's a quick summary of how to use Lucid for role-play and story-writing:
system
: Use this role to set up the scenario (plot, setting, writing style, etc.).writer
: Write the story or role-play using this role.user
: Provide instructions (OOC) to the model.assistant
: Get writing assistance from the model.
System Prompt
The system prompt is very flexible, and here are some recommendations and examples:
Intro
It's recommended to start the system prompt with an introduction like this:
You are a skilled {{writing_kind}} writer and writing assistant with expertise across all genres{{genre_suffix}}.
{{writing_kind}}
should befiction
for story-writing androle-play
for role-playing.{{genre_suffix}}
can be empty or something like(but you specialize in horror)
.
Roles
Explain the writing roles in the system prompt:
- Story-writing:
You will perform several tasks, switching roles as needed:
- Writing: Use the `writer` role to write a story based on the provided information and user instructions.
- Other: Use the `assistant` role for any other tasks the user may request.
- Role-playing:
You will perform several tasks, switching roles as needed:
- Role-playing: Use the `writer` role to write a role-play based on the provided information and user instructions. Use the `writer character <character_name>` role for dialog or when acting as a specific character, use the `writer narrative` role for narration.
- Other: Use the `assistant` role for any other tasks the user may request.
Structured Scenario Information
The model understands structured scenario information, which can include plot, style, setting, characters, etc. (all sections are optional).
Markdown Style
```python # Role-Play Information ## Plot {{ description of the plot, can be open-ended }} ## Previous Events {{ summary of what happened before -- like previous chapters or scenes }} ## Setting {{ description of the setting }} ## Writing Style {{ description of the writing style }} ## Characters ### {{character's name}} {{ description of the character }} ### {{character's name}} {{ description of the character }} ## Locations {{ like characters }} ## Items {{ like characters }} ```XML Style
```python # Role-Play InformationOther recommendations:
- Write descriptions as plain sentences, paragraphs, or bullet points.
- If the plot description is open-ended, start with something like this:
[ The following plot description is open-ended and covers only the beginning of the {{writing_kind}}. ]
where {{writing_kind}}
is story
or role-play
.
Example: Science Fiction Story
Input
```python <|start_header_id|>system<|end_header_id|> You are a skilled fiction writer and writing assistant with expertise across all genres (but you specialize in Science Fiction). You will perform several tasks, switching roles as needed: - Writing: Use the `writer` role to write a story based on the provided information and user instructions. - Other: Use the `assistant` role for any other tasks the user may request. # Story Information ## Plot [ The following plot description is open-ended and covers only the beginning of the story. ] In the bleak expanse of space, Tess, a seasoned scavenger clad in a voidskin, meticulously prepares to breach a derelict ark vessel. Her partner, the pragmatic Lark, pilots their ship, guiding Tess towards a promising entry point on the starboard side. This particular spot, identified by its unusual heat signature, hints at a potentially intact nerve center, a relic of the ship's former life. As they coordinate their approach, fragments of their shared past surface: their daring escape from the dismantling of Nova-Tau Hub and the acquisition of their vessel, the "Rustbucket," burdened by a substantial debt. The lure of riches within the unbreached ark vessel hangs heavy in the air, tempered by the knowledge that other scavengers will soon descend, transforming the find into a frenzied feeding ground. The need for speed and precision is paramount as Tess and Lark initiate the breach, stepping into the unknown depths of the derelict vessel. ## Setting The story unfolds in a distant, unspecified future, long after humanity has colonized space. Earth, or "the homeland," is a distant memory, its oceans and creatures relegated to historical data. The primary setting is the cold, dark void of space, where derelict "ark vessels"—massive vessels designed to carry generations of colonists—drift as "spacegrave," decaying carcasses ripe for scavenging. Physically, the story takes place within and around these ark vessels and the scavengers' smaller, utilitarian "Rustbucket." The ark vessels are described as station-sized, containing server farms, cryotube chambers filled with broken glass, and dimly lit corridors marked with pictographic signs. Colors are muted, dominated by blacks, blues, and the occasional "blood-red hotspot" indicating active electronics. The air is thin, oxygen scarce, and the temperature varies from frigid to warm near active systems. Sounds include the hum of generators, the hiss of airlocks, and the clank of magnetized boots on metal hulls. Socially, the setting is defined by a corpostate hegemony, leaving many, like Tess and Lark, deeply in debt and forced into dangerous scavenging work. The culture is pragmatic and utilitarian, valuing raw materials over historical preservation. Technology is advanced, featuring jump drives, voidskins, slicers (bladed tools), and cryotubes, but is often unreliable and jury-rigged. Legal claims to derelict ships are determined by the presence of living survivors, creating a moral conflict for the scavengers. ## Writing Style - The story employs a first-person perspective, narrated by Tess, offering a limited yet intimate view of events. Tess's voice is informal, pragmatic, and tinged with cynicism ("Rustbucket"), reflecting her working-class background and life as a scavenger. Her reliability as a narrator is questionable, as she often rationalizes morally ambiguous decisions. - The tense is primarily present, creating immediacy, with occasional shifts to the past for reflection. - The tone blends cynical detachment with underlying sentimentality, revealing a capacity for empathy beneath Tess's tough exterior. - Vivid imagery and sensory details paint a bleak yet compelling picture of decaying ark vessels and the harsh realities of space scavenging. - Simple, straightforward language is interspersed with technical jargon, grounding the story in its sci-fi setting. - Figurative language, such as the central "spacegrave" metaphor, enhances imagery and conveys complex ideas about decay and lost potential. - The dialogue is authentic, advancing the plot and revealing character traits. Tess's pragmatic speech contrasts with Lark's more intellectual and idealistic language, highlighting their differing personalities. - The story explores themes of survival, loyalty, and the conflict between pragmatism and morality, reinforced by recurring motifs and stylistic choices. ## Characters ### Tess Tess is a hardened scavenger in her late twenties or early thirties with a practical approach to surviving in the harsh void of space. Years of exostation welding have made her physically strong, capable of handling heavy equipment and enduring difficult conditions. She carries psychological scars from past violence during her time at Nova-Tau, which manifests as emotional guardedness. Though her exterior is stoic and her communication style blunt, she harbors deep loyalty toward her partner Lark. Tess often dismisses speculation and sentiment in favor of immediate action, yet occasionally allows herself brief moments of peace and reflection. Her speech is terse and direct, complementing her no-nonsense approach to their dangerous profession. Beneath her pragmatic facade lies an ongoing internal struggle between the ruthlessness required for survival and her persistent humanity. ### Lark Lark serves as Tess's partner and counterbalance, bringing curiosity and emotional expressiveness to their scavenging team. Approximately Tess's age, Lark possesses sharp analytical skills that prove invaluable during their operations. She excels at technical scanning and data interpretation, often identifying optimal entry points and valuable salvage opportunities. Unlike Tess, Lark maintains an enthusiastic interest in history and cultural artifacts, collecting media from different eras and frequently sharing historical knowledge. Her communication style is conversational and expressive, often employing humor to process difficult situations. While practical about their survival needs, Lark struggles more visibly with the moral implications of their work. She values knowledge and understanding alongside material gain, seeing connections between past civilizations and their present circumstances. Her relationship with Tess forms the emotional core of her life, built on shared experiences and mutual dependence. ## Locations ### Ark Vessel - Massive, derelict spacecraft, heavily decayed from centuries adrift in space. - Originally built to sustain multiple generations during interstellar travel. - Contains a variety of sections, including decayed living quarters, server farms filled with obsolete technology, cryotube chambers, vast storage facilities, and the potential for long-dead gardens or greenspaces. - The interior is a hazardous environment due to structural instability and the potential presence of surviving inhabitants or automated defense systems. - A prime target for scavengers seeking valuable resources, historical artifacts, and exotic technology. ### The Rustbucket - A small, old, and unreliable spacecraft, stolen from Nova-Tau Hub. - Equipped with a jump drive (the source of a significant debt) for interstellar travel. - Contains an airlock for accessing external environments and basic, often strained, life support systems, including oxygen scrubbers. - The cramped interior serves as both living quarters and workspace, filled with salvage equipment, tools, and essential living supplies. ## Items ### Voidskin Protective spacesuit with sealed atmosphere, magnetic boots, and night vision. Essential for surviving vacuum, temperature extremes, and radiation. Re-zippable design. ### Slicer Cutting tool/weapon projecting an energy blade. Used to slice through durable materials like spaceship hulls. ### Jump Drive Enables faster-than-light interstellar travel. Crucial for trade, exploration, and scavenging. Expensive technology. ## Story Info - Length: 2000 words. - Quality: 10 / 10 (Very Good)<|eot_id|> ```Output (partial)
```python <|start_header_id|>writer<|end_header_id|> My voidskin is sealed, my slicer primed and ready. My magnetized boots clank against the rusted hull of the ark vessel we’ve targeted for this run. It’s the first of the trip, so we have to make it count. If we don’t come out with a good haul, we’re as good as dead. Our life-support systems are almost completely out, and the jump drive on the _Rustbucket_ is as old as the day is long. “You’ve got the starboard side, right?” Lark’s voice comes through the comm, clear and crisp. “Yeah, I’ve got it. I can see the hotspot, too,” I say. “It’s about a kilometer up, toward the nose.” “That’s probably where you’ll find the nerve center. If we get lucky, it won’t be a fucking server farm.” “Wouldn’t count on it, though.” My breath fogs in front of me, visible in the low light. “Probably right.” We’d gotten lucky with this ark. It was station-sized, which meant more space for salvage, and it hadn’t been breached yet. Its heat map showed a few blood-red hotspots, and there were no signs of salvage operations in the vicinity. We’d be first on site, which meant we’d have the pick of the litter, at least for a few hours. Then the rest of them would come. I glance at my wrist screen and watch the counter. Thirty minutes before we’re supposed to rendezvous again. I continue up the hull, slicer out and ready. The skin of the ark is so degraded it feels like it’ll crumble under my feet. I wonder how many centuries it’s been out here. How many more it has left before it disintegrates. We’re out far enough from the gravity wells that it doesn’t have a set orbit. Just adrift, spinning in space. A spacegrave. Lark and I found the first spacegrave just after we’d gotten the _Rustbucket_. The name’s a little on the nose, but it’s what she’d named her when she was a kid, so I’d let her keep it. Even after the Nova-Tau hub dismantling, even after we stole her, she kept the name. That’s how much it meant to her. _Rustbucket_, a small ship with a big jump drive that was just big enough for two. It was just the two of us. Two young women, alone on a small ship, far from home. We’d been lucky to get her at all ```
