KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

hacker-fables

★ 11 Open GitHub ↗

"Hacker Fables" - The satirical cyberpunk novella to read while your AI agent completes Jira tickets.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Hacker Fables

**The satirical cyberpunk novella to read while your AI agent completes Jira
tickets.**

[![Read Online](https://img.shields.io/badge/Read-Online-mediumseagreen?style=for-the-badge)](https://sebastiancarlos.github.io/hacker-fables)

> "Dan Brown on ketamine" — *The New York Times*  
> "Neon Genesis Evangelion meets programming" — *The Guardian*  
> "The world's first LeetCode-Hard Sci-Fi Novel" — *LeetCode Weekly Digest*

Welcome to the source code of **Hacker Fables**.

This repository contains both the text of the novella and the
open-source **[hacker-press](https://github.com/sebastiancarlos/hacker-press)**
publishing pipeline that compiles it.

If you just want to read the book, head over
**[here](https://sebastiancarlos.github.io/hacker-fables)** to read the HTML
version (with a built-in, **synchronized audiobook player**) or download the
EPUB, PDF, MP3 audiobook, MP4 audiobook video, Man Page, or GNU Info outputs.

That's right, you can **read it as a `man` page or with GNU `info`**:

```bash
# Read it as a man page
$ curl -sL https://sebastiancarlos.github.io/hacker-fables/hacker-fables.man | man -l -

# Or install it system-wide
$ curl -sL https://sebastiancarlos.github.io/hacker-fables/hacker-fables.man \
  | sudo tee /usr/local/share/man/man1/hacker-fables.1 > /dev/null \
  && man hacker-fables

# Read it as a GNU Info manual
$ info -f <(curl -sL https://sebastiancarlos.github.io/hacker-fables/hacker-fables.info)

# Or install it system-wide
$ curl -sL https://sebastiancarlos.github.io/hacker-fables/hacker-fables.info \
  | sudo tee /usr/local/share/info/hacker-fables.info > /dev/null \
  && sudo install-info /usr/local/share/info/hacker-fables.info \
  /usr/local/share/info/dir \
  && info hacker-fables
```

If you want to see how a single markdown file is **brutally** parsed into
eight different formats using Python, Pandoc (with Lua AST filters), Docker,
Piper TTS, Playwright, ffmpeg, `ebooklib`, WeasyPrint, and BeautifulSoup, this
repo might be of interest to you.

---

## Building it yourself

### Prerequisites

* `pandoc` and `makeinfo` on your `$PATH`.
* Python via `uv`.
* TTS requires a local `piper-tts` clone. Set `PIPER_PATH` in your `.env`
  file to point at it.
* Video build (`--video`) requires
  [Playwright](https://playwright.dev/python/) with Chromium
  (`uv run playwright install chromium`) and `ffmpeg` on your `$PATH`.

### Setup & Build

```bash
# Install dependencies
uv sync

# Build all defaults (HTML, EPUB, PDF, Man Page, Info, Markdown, audio)
./build.sh

# Build specific targets
./build.sh --html --pdf

# Build audiobook video
./build.sh --video

# Force full rebuild
./build.sh --force
```

All compiled artifacts will be placed in the `output-documents/` directory.

See the [`hacker-press`](https://github.com/sebastiancarlos/hacker-press)
README for the full CLI reference, semantic conventions, and extension points.

## Project Anatomy

* `source.text.md`: The one and only source.
* `assets/`: Static files (cover image, diagrams, intro music).
* `public/`: Web-server content (landing page, CSS, web-only assets).
* `filters/`: Project-specific Pandoc Lua filters.
* `templates/`: Project-specific CSS templates.
* `build.sh`: Build entry point (wraps `hacker-press` CLI).
* `test.py`: Test suite.

## License

The **publishing pipeline** (everything except the novella's text) is licensed
under the MIT License. See [LICENSE](./LICENSE).

The **text of the novella itself** (`source.text.md` and all compiled outputs:
HTML, EPUB, PDF, audiobook, etc.) is © Sebastian Carlos.

hacker-fables

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README