Skip to content

primer-narrative-finance

Academic Primer on Narrative Finance - 52-page PhD-level working paper with 21 reproducible figures

View on GitHub

Information

Property Value
Language Python
Stars 0
Forks 0
Watchers 0
Open Issues 0
License No License
Created 2025-12-30
Last Updated 2026-02-19
Last Push 2026-01-04
Contributors 1
Default Branch main
Visibility private

Datasets

This repository includes 19 dataset(s):

Dataset Format Size

| data | | 0.0 KB |

| embeddings | | 0.0 KB |

| .gitkeep | | 0.0 KB |

| processed | | 0.0 KB |

| .gitkeep | | 0.0 KB |

| raw | | 0.0 KB |

| .gitkeep | | 0.0 KB |

| data | | 0.0 KB |

| init.py | .py | 0.35 KB |

| generators | | 0.0 KB |

| data | | 0.0 KB |

| processed | | 0.0 KB |

| raw | | 0.0 KB |

| data | | 0.0 KB |

| init.py | .py | 0.04 KB |

| verify_calculations.py | .py | 5.66 KB |

| verify_statistics.py | .py | 6.08 KB |

| manifest.json | .json | 0.74 KB |

| manifest.json | .json | 1.22 KB |

Reproducibility

This repository includes reproducibility tools:

  • Python requirements.txt

  • Dockerfile for containerization

  • Makefile for automation

Status

  • Issues: Enabled
  • Wiki: Enabled
  • Pages: Enabled

README

Primer on Narrative Finance

A comprehensive introduction to narrative finance for advanced researchers.

Overview

This repository contains a 30-page PhD-level academic primer on narrative finance, including:

  • Full mathematical formalization with derivations
  • Comprehensive methods coverage: NLP, LLMs, econometrics, networks
  • Case studies from historical bubbles to modern meme stocks
  • Reproducible figures generated from code
  • Triple-verified citations via API

Target audience: Senior professors and advanced researchers in finance, economics, and related fields.

Quick Start

Prerequisites

  • Python 3.11+
  • Poetry (Python package manager)
  • LaTeX distribution (TeX Live or MiKTeX)
  • Just (command runner)

Installation

# Clone repository
git clone https://github.com/Digital-AI-Finance/primer-narrative-finance.git
cd primer-narrative-finance

# Install Python dependencies
poetry install

# Verify installation
poetry run python -c "import narrative_finance; print('OK')"

Build the Paper

# Generate all figures
just figures

# Build PDF (full with bibliography)
just build

# Or run everything at once
just all

View Output

The compiled PDF will be at paper/main.pdf.

Repository Structure

primer-narrative-finance/
├── paper/                    # LaTeX source
│   ├── main.tex             # Master document
│   ├── preamble.tex         # Packages and commands
│   ├── notation.tex         # Notation table
│   ├── glossary.tex         # Glossary definitions
│   ├── sections/            # Main content (5 sections)
│   │   ├── 01_introduction.tex
│   │   ├── 02_theory.tex
│   │   ├── 03_methods.tex
│   │   ├── 04_applications.tex
│   │   └── 05_conclusions.tex
│   └── appendices/          # Mathematical appendices
├── figures/                  # Figure generation
│   ├── _shared/             # Shared utilities (colors, styles)
│   ├── _templates/          # Chart templates
│   └── XX_name/             # Individual figures (21 folders)
├── bibliography/            # Citations
│   ├── references.bib       # Main bibliography
│   ├── seed_papers.md       # Seed papers for lit review
│   └── verification_log.md  # Citation verification records
├── notebooks/               # Jupyter notebooks
├── scripts/                 # Build and utility scripts
├── src/narrative_finance/   # Python package
├── pyproject.toml           # Poetry configuration
├── justfile                 # Build commands
└── CLAUDE.md               # AI assistant instructions

Available Commands

Run just --list to see all available commands. Key commands:

Command Description
just install Install dependencies
just figures Generate all figures
just build Build PDF
just verify-citations Verify all citations
just qa Run all quality checks
just word-count Count words per section
just all Full build workflow
just jupyter Start Jupyter Lab

Content Overview

Part 1: Introduction (~6 pages)

  • What is narrative finance?
  • Relationship to behavioral finance
  • Historical development

Part 2: Theoretical Foundations (~6 pages)

  • Narrative contagion (SIR models)
  • Information cascades
  • Attention and salience models

Part 3: Methods (~6 pages)

  • NLP and text analysis
  • Large language models (central focus)
  • Econometric identification
  • Network analysis

Part 4: Applications (~6 pages)

  • Historical bubbles (Tulip, South Sea, 1929)
  • Modern crises (dot-com, 2008, COVID)
  • Cryptocurrency and meme stocks
  • ESG narratives

Part 5: Policy and Conclusions (~6 pages)

  • Policy implications
  • Regulatory aspects
  • Open research questions

Appendices (~15-20 pages)

  • Mathematical proofs
  • Extended derivations
  • Data catalog
  • Exercises

Citation

If you use this primer in your research, please cite:

@techreport{osterrieder2024narrative,
  author = {Osterrieder, Joerg},
  title = {Primer on Narrative Finance: A Comprehensive Introduction for Researchers},
  year = {2024},
  institution = {University of Applied Sciences of the Grisons},
  type = {Working Paper},
}

Contributing

This is a private research repository. Please contact the author for collaboration inquiries.

License

Copyright (c) 2024 Joerg Osterrieder. All rights reserved.

Acknowledgments

  • Robert Shiller for foundational work on narrative economics
  • The behavioral finance community
  • OpenAlex and Semantic Scholar for citation APIs