git404hub

what is ai-summary fr?

daviid-p/ai-summary — explained in plain English

Analysis updated 2026-05-18

1PythonAudience · developerComplexity · 3/5Setup · moderate

tl;dr

A Python tool that uses a local AI model to summarize long web novels chapter by chapter, while tracking characters and plot details in an ongoing knowledge graph.

vibe map

mindmap
  root((AI Summary))
    What it does
      Chapter by chapter summaries
      Knowledge graph tracking
      Long novel processing
    Tech stack
      Python
      Ollama
      OpenAI compatible API
    Use cases
      Summarize web novels
      Track story characters
      Resume interrupted runs
    Output
      Chapter summary files
      Registry knowledge graph
      Event log
    Audience
      Developers
      Novel readers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Generate chapter-by-chapter summaries of very long web novels using a local or hosted AI model.

VIBE 2

Track characters, events, and plot threads across thousands of chapters in a knowledge graph.

VIBE 3

Resume or reprocess chapter summaries as new chapters of a story are released.

what's the stack?

PythonOllamaOpenAI API

how it stacks up fr

daviid-p/ai-summary0xustaz/streamgatea-bissell/unleash-lite
Stars111
LanguagePythonPythonPython
Setup difficultymoderatehardhard
Complexity3/54/54/5
Audiencedeveloperdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires Ollama or an OpenAI-compatible API running locally or remotely, plus a folder of chapter text files.

in plain english

This project is a Python script that reads long web novels, chapter by chapter, and generates a plain-English summary for each one using a large language model, the same kind of AI technology behind chatbots. It was written specifically to handle very long stories, thousands of chapters in length, by keeping track of characters, events, and story details across the whole novel rather than summarizing each chapter in isolation. To do this, the tool builds and updates what it calls a knowledge graph as it works through the chapters, a structured record of characters, their traits, ongoing plot threads, and important events. As the story grows, this record can get too large to hand entirely to the AI model each time, so the tool periodically compacts it, trimming or archiving details about characters and events that have not been relevant recently, while keeping full records of everything in a separate archive file just in case. The script is designed to run with Ollama, a tool for running AI language models directly on a person's own computer rather than through an online service, though it can also connect to OpenAI compatible services if a user prefers a hosted model instead. Someone using it points the script at a folder of chapter files, and it processes them one at a time or in small batches, writing a short summary for each chapter along with an ongoing log of story events. It can resume where it left off if interrupted, skip chapters already summarized, or be told to start over from scratch. The output includes individual chapter summaries, the running knowledge graph in its current and archived forms, an event log tracking what happened and who was involved, and a processing log recording how the run went. The author is upfront that the entire script was written by an AI assistant and shared as is because it worked for their own specific use case. They encourage anyone trying it to read through the code and test it carefully rather than trusting it without checking, and they welcome bug reports and contributions from others.

prompts (copy fr)

prompt 1
Help me run summarize.py on a folder of chapter files using Ollama and the qwen2.5 model.
prompt 2
Explain how this tool's knowledge graph compaction keeps track of characters across thousands of chapters.
prompt 3
Show me how to switch this script from Ollama to an OpenAI-compatible API for summarization.
prompt 4
Walk me through the output folder structure this tool creates for summaries, registry, and logs.

Frequently asked questions

what is ai-summary fr?

A Python tool that uses a local AI model to summarize long web novels chapter by chapter, while tracking characters and plot details in an ongoing knowledge graph.

What language is ai-summary written in?

Mainly Python. The stack also includes Python, Ollama, OpenAI API.

How hard is ai-summary to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is ai-summary for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.