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."

4. 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 & Authorization

This repository is a technical showcase for Story Engine. Copyright © 2026 Shanghai Linming Junhua Technology Co., Ltd. and NOHN AI TECHNOLOGY PTE. LTD. All rights reserved.

User	Purpose	License Requirement
Individual (natural person)	Non-commercial academic research / study / personal experimentation	Free under the "Free Individual Research License" in LICENSE
Government agency / public institution / enterprise	Any purpose (incl. internal deployment, product development, service provision)	Requires prior written paid authorization

• Individual researchers may use the Work free of charge for non-commercial research under LICENSE, but not for any commercial purpose, nor to provide services to any enterprise or government organization.
• Government / enterprise users may not copy, deploy, run, integrate, or distribute the Work before signing a Commercial Authorization Agreement and paying the agreed fee.
• Apply for authorization:
  • International / Global: ai@nohnlins.com
  • China: ai@tx.nohnlins.com

The licensor, governing law, and dispute resolution are determined by the user's location as set out in LICENSE: users within the PRC → Shanghai Linming Junhua Technology Co., Ltd. (laws of the PRC); users outside the PRC → NOHN AI TECHNOLOGY PTE. LTD. (laws of Singapore, SIAC arbitration).

Get started

git clone https://gitee.com/lin-mingjun-hua_0/story-engine.git
cd story-engine

Happy writing – without the headaches. ✍️