whatisgithub

What is sotu?

bmschmidt/sotu — explained in plain English

Analysis updated 2026-07-17 · repo last pushed 2015-01-21

2JavaScriptAudience · researcherComplexity · 2/5DormantSetup · moderate

In one sentence

Interactive web pages for exploring how language and topics in presidential State of the Union speeches have changed over American history.

Mindmap

mindmap
  root((sotu))
    What it does
      Visualizes SOTU speeches
      Tracks language over time
      Interactive browsing
    Tech stack
      JavaScript
      HTML
      Python backend
    Use cases
      Political research
      Rhetoric analysis
      History exploration
    Audience
      Researchers
      Journalists
      Curious readers
    Origin
      Bookworm project
      Atlantic articles
      Stripped-down code

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

Explore how the language and topics in State of the Union speeches shifted across different presidencies.

USE CASE 2

Research political communication trends without reading hundreds of speeches manually.

USE CASE 3

Study when specific themes, like the economy, became more prominent in presidential rhetoric.

USE CASE 4

Reference the interactive visualizations while writing journalism or academic articles on political speech.

What is it built with?

JavaScriptHTMLPythonMakefiles

How does it compare?

bmschmidt/sotu3imed-jaberi/cryptography-si-isamm3imed-jaberi/koa-isomorphic-router
Stars222
LanguageJavaScriptJavaScriptJavaScript
Last pushed2015-01-212021-09-252021-02-06
MaintenanceDormantDormantDormant
Setup difficultymoderateeasyeasy
Complexity2/51/52/5
Audienceresearcherresearcherdeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 1h+

The data-preparation backend is a separate Python and Makefile system not fully documented here.

So what is it?

This is a collection of web pages that visualize and explore State of the Union addresses over time. The README suggests it's part of research done with a collaborator on articles published in The Atlantic, examining patterns in presidential speeches. The project provides interactive HTML and JavaScript pages that let you browse through SOTU speeches, likely seeing how language and topics have changed across different presidencies and eras. The actual heavy lifting, parsing the speech texts and preparing the data, happens in a separate backend system (built with Python and Makefiles), but this repository contains the user-facing interface that lets people explore the results. The code is borrowed from the creator's larger Bookworm project (a text analysis tool), but stripped down to remove unnecessary complexity and focus just on what's needed for visualizing these speeches. This is a pragmatic choice: rather than carrying around a ton of unrelated code, they extracted just the relevant pieces. You'd use this if you're researching how presidential rhetoric has evolved, studying political communication, or just curious about what themes and language choices have dominated State of the Union addresses across American history. It's the kind of tool that lets you ask questions like "when did presidents start talking about the economy more?" or "how has the tone changed over the decades?" without needing to read hundreds of speeches yourself.

Copy-paste prompts

Prompt 1
Explain how the SOTU visualization pages in this repo let me explore changes in presidential speech language over time.
Prompt 2
Help me set up the Python backend that parses and prepares the State of the Union speech data for this project.
Prompt 3
Show me how this repo reuses and simplifies code from the Bookworm text-analysis project.
Prompt 4
Walk me through running the HTML and JavaScript pages in this repo locally to browse the speech visualizations.

Frequently asked questions

What is sotu?

Interactive web pages for exploring how language and topics in presidential State of the Union speeches have changed over American history.

What language is sotu written in?

Mainly JavaScript. The stack also includes JavaScript, HTML, Python.

Is sotu actively maintained?

Dormant — no commits in 2+ years (last push 2015-01-21).

How hard is sotu to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is sotu for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.