explaingit

ghostwrittenstudios/ai-against-humanity

Analysis updated 2026-05-18

1JavaScriptAudience · vibe coderComplexity · 2/5Setup · moderate

TLDR

A Cards Against Humanity style party game where every card is written live by a local AI instead of a fixed deck.

Mindmap

mindmap
  root((ai-against-humanity))
    What it does
      AI written cards
      Rotating Card Czar
      Fallback deck
    Tech stack
      JavaScript
      Electron
      Ollama
      Python
    Use cases
      Solo party game
      LAN multiplayer
      Learn Electron plus LLM
    Audience
      Vibe coders
      Hobby gamers

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

Play a solo party card game against AI opponents at home.

USE CASE 2

Host a LAN game so friends on phones can join from the same network.

USE CASE 3

Study the code as an example of building a small Electron app around a local LLM.

What is it built with?

JavaScriptElectronOllamaPython

How does it compare?

ghostwrittenstudios/ai-against-humanity0xmukesh/docusaurus-tutorial1tsmejp/palworld-docker-wine
Stars111
LanguageJavaScriptJavaScriptJavaScript
Last pushed2021-12-27
MaintenanceDormant
Setup difficultymoderateeasymoderate
Complexity2/52/54/5
Audiencevibe coderdeveloperops devops

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Ollama running locally with a downloaded model.

In plain English

AI Against Humanity is a single-player party game modeled on Cards Against Humanity, except every card is written on the spot by a local AI running through Ollama instead of being pulled from a fixed deck. You sit at a virtual table with three computer-controlled players named Rebecca, Timothy, and Steve, and the role of Card Czar rotates each round. Whoever reaches the target score first, seven points by default, wins the game. To play, you need Ollama running on your own machine along with a downloaded language model such as gemma3:4b or a smaller option for weaker computers. If the AI cannot be reached for any reason, the game does not stop working, it simply falls back to a built-in set of cards so you can keep playing. You can run the game in a web browser using a small Python script to serve the files, or use a packaged desktop app for Windows and Mac that bundles everything so you do not need Python or any manual setup. The desktop version, built with Electron, handles communication with Ollama internally and keeps the game interface sandboxed, meaning it cannot access your files or the network beyond what is needed to talk to the AI. The project also supports playing from a phone or tablet on the same home network, which requires changing a couple of Ollama settings so it accepts connections from other devices. The code is organized into a handful of JavaScript files that separate round logic, the AI connection, the visual interface, and the offline fallback deck, which keeps the project easy to follow for someone who wants to see how it works. The developer lists several ideas for the future, including themed card packs, an AI-controlled Card Czar, online multiplayer, and a version that runs on Android phones.

Copy-paste prompts

Prompt 1
Walk me through installing Ollama and pulling a model so I can run ai-against-humanity.
Prompt 2
Explain how desktop/preload.cjs and desktop/main.cjs sandbox the Electron renderer in this project.
Prompt 3
Show me how to add a new themed card pack to ai-against-humanity's prompt logic.
Prompt 4
Help me set up OLLAMA_ORIGINS and OLLAMA_HOST so I can play this game from my phone.

Frequently asked questions

What is ai-against-humanity?

A Cards Against Humanity style party game where every card is written live by a local AI instead of a fixed deck.

What language is ai-against-humanity written in?

Mainly JavaScript. The stack also includes JavaScript, Electron, Ollama.

How hard is ai-against-humanity to set up?

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

Who is ai-against-humanity for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.