Skip to content

nohn3043-arch/story-engine

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

25 Commits
 
 
 
 
 
 
 
 

Repository files navigation

A story has to make sense

Story Engine

A writing tool that keeps your story consistent from beginning to end – no more plot holes or characters acting out of character.

What does it do?

You give it a starting idea. It helps you write a full story where:

  • Characters stay true to themselves (no sudden personality changes).
  • The plot flows logically (no "wait, how did we get here?" moments).
  • Past events are remembered (foreshadowing doesn't get lost).

Who is it for?

  • Writers who struggle with long‑form consistency.
  • Screenwriters who need to track plot threads.
  • Game developers who build narrative‑driven worlds.
  • Anyone who wants to tell a story without breaking its own rules.

How to use it

  1. Clone the repository.
  2. Install a few dependencies (Python 3.9+).
  3. Run the engine with a simple text prompt:

python story_engine.py --seed "A young woman discovers her best friend has been lying to her for years."

  1. The engine will generate a chapter‑by‑chapter outline, check every “because → so” step, and produce a story that holds together.

No technical background required. The engine does the logic checking for you – you just review and edit the output.

Example

Input:
Elena, a detective, finds a torn photo in her missing partner's drawer.

Output (short excerpt):
“Elena stares at the photo. It was taken two days before he vanished. Her hand shakes – not from fear, but from the realisation that the person in the background is her own boss.”

The engine ensures that later chapters never forget the photo, the boss's role, or Elena's emotional state.

License

  • Free for personal / research use.
  • Commercial use requires permission.
    Contact: ai@nohnlins.com

Get started

git clone https://github.com/nohn3043-arch/story-engine.git
cd story-engine

Happy writing – without the headaches. ✍️

About

确定性故事生成引擎:基于因果逻辑审计的叙事生成工具,保持角色性格与剧情发展完全一致,彻底消除逻辑漏洞与设定冲突,适用于游戏叙事、影视剧本创作、互动小说、IP内容生产、AIGC内容生成场景。

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages