# shenminglinyi/PlotPilot

【墨枢】作者的领航员

Repository: https://github.com/shenminglinyi/PlotPilot
Canonical: https://ross.abutalabs.com/products/plotpilot
Language: Python
License: NOASSERTION
License Family: other
Last push: 2026-08-24T14:59:59+00:00

## Health v2 (maintenance only)
Score: 77/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 87, longevity 10
- inputs: {"age_days": 149, "days_push": 9, "days_rel": 85, "gap_med": 2, "n_releases_24m": 10}
- flags: young, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1454, forks 447 (observed 2026-08-28T04:04:46.748043+00:00)

## What it is
PlotPilot (墨枢) is an open-source narrative engine kernel for long-form AI-assisted fiction and script writing, built in Python with FastAPI and a Vue workbench. It maintains persistent narrative state (story bible, chapter summaries, event streams, story-line DAGs, foreshadowing registry) and uses vector retrieval (FAISS/ChromaDB) plus an automated multi-step chapter generation pipeline to keep characters, causality, and plot threads consistent across hundreds of thousands of words.

## Use cases
- write a long novel with AI while keeping characters consistent
- generate book chapters automatically without the model forgetting the plot
- track foreshadowing and plot hooks across a long story
- manage a story bible and world-building knowledge base for fiction
- run an unattended AI pipeline that drafts and audits chapters
- search past chapters semantically for continuity when writing
- visualize storylines and character relationships as a DAG

## When to choose
- you are producing long-form serialized fiction or scripts with LLMs and need state management beyond prompt templates
- you want a self-hosted engine with a REST API to build your own writing tools on top of
- you need structured narrative state (story bible, foreshadowing registry, chapter summaries) rather than one-shot text generation

## When to avoid
- you just need a simple chat-style writing assistant or one-shot text continuation
- you want a polished end-user product rather than an engine kernel under active rework
- you need a permissively licensed dependency - it uses Apache 2.0 plus Commons Clause, restricting commercial resale

## Facets
- artifact type: framework
- maturity: active
- function: rag, llm-inference, agent-framework, nlp, api-framework, search-engine, data-visualization
- domain: artificial-intelligence, large-language-models, developer-tools
- platform: python, self-hosted, cross-platform
- tags: narrative-engine, ai-writing, story-bible, vector-retrieval, faiss, chromadb, fastapi, creative-writing, long-form-fiction, plot-consistency, knowledge-graph, story-pipeline, natural-language-processing, retrieval-augmented-generation, ai-agents, web-server

## Member repositories
- shenminglinyi/PlotPilot (main) score 77

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:46.748043+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:35:42.630800+00:00, confidence not recorded.
  - readme: https://github.com/shenminglinyi/PlotPilot (fetched 2026-08-28T04:04:46.748043+00:00, sha 907397b8cd75)
- Data as of 2026-08-30T08:39:29.467469+00:00.