explaingit

kiara-01-lab/fast-manga-oss

0PythonAudience · developerComplexity · 4/5ActiveLicenseSetup · moderate

TLDR

Python pipeline that turns Slack, Notion, and GitHub activity logs into a four-panel manga strip celebrating an under-recognized contributor, using a Ki-Sho-Ten-Ketsu story arc.

Mindmap

mindmap
  root((fast-manga-oss))
    Inputs
      Activity logs
      JSON brief
      Protagonist data
    Outputs
      Four panel manga
      Story script
      Optional audio
    Use Cases
      Spotlight quiet contributors
      Generate team recap art
      Demo deterministic plus LLM pipeline
    Tech Stack
      Python
      Ollama
      Claude
      DALL-E
      MusicGen

Things people build with this

USE CASE 1

Turn team activity logs into a four-panel manga that highlights an unsung contributor

USE CASE 2

Run a placeholder smoke test pipeline with no API keys to learn the stage layout

USE CASE 3

Swap in DALL-E or a local Stable Diffusion server for the image stage

USE CASE 4

Generate a story brief from a JSON file describing protagonist, problem, and resolution

Tech stack

PythonOllamaClaudeDALL-EStable DiffusionMusicGen

Getting it running

Difficulty · moderate Time to first run · 30min

Default placeholder run needs no API keys, but real images or stories require either Ollama with Qwen, an Anthropic key, DALL-E, or a local Automatic1111 server.

MIT, use, copy, modify, and ship for any purpose as long as the copyright notice stays.

In plain English

FastManga OSS, also called FDS for FastLoop Documentary System, is a Python tool that reads activity logs from work tools (Slack, Notion, GitHub) and produces a four-panel manga strip telling a human story about what the team did. The pitch in the README is that small contributors who do real work but cannot self-promote are usually invisible, and this tool finds them in the logs and tells their story automatically. Three example stories ship with the repo: a Tokyo startup founder pitching with no time, a Taipei fashion brand pop-up, and an NPO running a zero-budget marketing push. The pipeline has five stages. The first stage scores activity logs to pick a protagonist, and is fully deterministic so the result is reproducible. The second stage calls a large language model to write a four-act story using the classical Japanese Ki-Sho-Ten-Ketsu structure (setup, escalation, turning point, resolution). The third stage compiles that story into a panel layout, again deterministic and unit-tested. The fourth stage generates the panel images, with a pluggable adapter that defaults to placeholders and can switch to DALL-E or Stable Diffusion. The fifth optional stage adds audio through MusicGen or Coqui TTS. The default run needs no API keys: it produces placeholder images and serves as a smoke test for the rest. To get real stories, the README documents four options: a local Ollama setup with Qwen3.5 72B, an Anthropic Claude cloud setup, DALL-E for real images, or a local Stable Diffusion server through Automatic1111. Users write a brief as a JSON file with fields for protagonist, problem, the role the product plays, the resolution, the emotion, the setting, and an optional activity log. Three deployment tiers let the user choose whether Chinese LLMs are included, excluded, or whether only local models are used, which the README frames as a compliance choice for regulated environments. The project also includes a prompt sanitizer that blocks named manga and anime IP before generation, replacing the term with a generic equivalent, and a provenance logger that records the original and sanitized prompt, the model, and the seed for each image. The code is MIT licensed.

Copy-paste prompts

Prompt 1
Run fast-manga-oss in placeholder mode to produce a four-panel strip from the included Tokyo startup founder brief
Prompt 2
Configure fast-manga-oss to use a local Ollama Qwen3.5 model for the story stage and Automatic1111 for images
Prompt 3
Write a JSON brief for fast-manga-oss that turns my last sprint's GitHub PRs into a manga about the QA engineer
Prompt 4
Add a new image adapter to fast-manga-oss that calls Replicate instead of DALL-E
Open on GitHub → Explain another repo

Generated 2026-05-22 · Model: sonnet-4-6 · Verify against the repo before relying on details.