explaingit

grettirjacobs/editorial-council

Analysis updated 2026-05-18

0PythonAudience · writerComplexity · 3/5LicenseSetup · moderate

TLDR

An open-source multi-agent system that runs on your own computer to produce a full editorial brief for a novel manuscript.

Mindmap

mindmap
  root((Council))
    What it does
      Analyzes a manuscript
      Produces one editorial brief
      Covers continuity and style
      Covers plot and pacing
    Tech stack
      Python
      Ollama
      OpenRouter
    Use cases
      Get a full manuscript review
      Rerun a single dimension
      Try sample novels first
    Audience
      Novelists
      Writers
      Editors

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 build with it?

USE CASE 1

Feed a full manuscript into Council to get one consolidated editorial brief covering continuity, style, and pacing.

USE CASE 2

Run only one editorial dimension, like theme or character analysis, to check a single revision quickly.

USE CASE 3

Try the tool on the included public domain novels before uploading your own manuscript.

USE CASE 4

Use local-only mode to analyze a manuscript with nothing leaving your computer.

What is it built with?

PythonOllamaOpenRouterPydantic

How does it compare?

grettirjacobs/editorial-council0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity3/52/54/5
Audiencewritergeneraldeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs a local Ollama model server or an API key, worldbuilding specifically requires a cloud model.

MIT license lets you use, modify, and share the code freely, including for commercial purposes.

In plain English

Council is a multi-agent editorial system built for novelists. You feed it a manuscript, and a set of specialized software agents, called clerks, each look at one aspect of the writing: continuity, outline, style, voice, characters, themes, plot, worldbuilding, and pacing. Their separate findings are combined into one editorial brief plus per-dimension structured data files. The tool is designed to run on your own computer. If you connect it to a local model server called Ollama, you can analyze a full manuscript for free, and nothing about your writing leaves your machine. If you want a stronger pass, you can instead supply your own API key, for example from MiniMax, and let a cloud model do the work. To try it out, the project comes with several public domain novels already included, such as The Picture of Dorian Gray and The Call of the Wild, so you can see how it works before pointing it at your own manuscript. Running the pipeline produces a finished brief you can read directly, and you can rerun just one part of the analysis, like the theme pass, instead of redoing everything. One part of the system, the worldbuilding analysis that extracts characters and settings into a map, needs a cloud based model rather than a local one, though a free OpenRouter key can cover that step at no cost. Every run ends with an honest result label, either complete, degraded with a note about what is missing, or failed, so you always know what you actually got. The project is written in Python and is licensed under MIT, meaning you are free to use, modify, and share it. There is also a strict privacy mode that blocks any outgoing network call except to your own machine, for anyone who wants to guarantee nothing leaves their computer.

Copy-paste prompts

Prompt 1
Help me set up Ollama locally so Council can analyze my manuscript for free.
Prompt 2
Walk me through running Council's pipeline on the Dorian Gray sample manuscript included in the repo.
Prompt 3
Explain the difference between running Council with a local model versus my own API key.
Prompt 4
Show me how to rerun just the worldbuilding stage of Council using a free OpenRouter key.

Frequently asked questions

What is editorial-council?

An open-source multi-agent system that runs on your own computer to produce a full editorial brief for a novel manuscript.

What language is editorial-council written in?

Mainly Python. The stack also includes Python, Ollama, OpenRouter.

What license does editorial-council use?

MIT license lets you use, modify, and share the code freely, including for commercial purposes.

How hard is editorial-council to set up?

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

Who is editorial-council for?

Mainly writer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.