Reddit’s API is effectively dead for archival. Third-party apps are gone. Reddit has threatened to cut off access to the Pushshift dataset multiple times. But 3.28TB of Reddit history exists as a torrent right now, and I built a tool to turn it into something you can browse on your own hardware.

The key point: This doesn’t touch Reddit’s servers. Ever. Download the Pushshift dataset, run my tool locally, get a fully browsable archive. Works on an air-gapped machine. Works on a Raspberry Pi serving your LAN. Works on a USB drive you hand to someone.

What it does: Takes compressed data dumps from Reddit (.zst), Voat (SQL), and Ruqqus (.7z) and generates static HTML. No JavaScript, no external requests, no tracking. Open index.html and browse. Want search? Run the optional Docker stack with PostgreSQL – still entirely on your machine.

API & AI Integration: Full REST API with 30+ endpoints – posts, comments, users, subreddits, full-text search, aggregations. Also ships with an MCP server (29 tools) so you can query your archive directly from AI tools.

Self-hosting options:

  • USB drive / local folder (just open the HTML files)
  • Home server on your LAN
  • Tor hidden service (2 commands, no port forwarding needed)
  • VPS with HTTPS
  • GitHub Pages for small archives

Why this matters: Once you have the data, you own it. No API keys, no rate limits, no ToS changes can take it away.

Scale: Tens of millions of posts per instance. PostgreSQL backend keeps memory constant regardless of dataset size. For the full 2.38B post dataset, run multiple instances by topic.

How I built it: Python, PostgreSQL, Jinja2 templates, Docker. Used Claude Code throughout as an experiment in AI-assisted development. Learned that the workflow is “trust but verify” – it accelerates the boring parts but you still own the architecture.

Live demo: https://online-archives.github.io/redd-archiver-example/ GitHub: https://github.com/19-84/redd-archiver (Public Domain)

Pushshift torrent: https://academictorrents.com/details/1614740ac8c94505e4ecb9d88be8bed7b6afddd4

  • offspec@lemmy.world
    link
    fedilink
    English
    arrow-up
    43
    arrow-down
    1
    ·
    13 hours ago

    It would be neat for someone to migrate this data set to a Lemmy instance

    • TeddE@lemmy.world
      link
      fedilink
      English
      arrow-up
      7
      ·
      2 hours ago

      It would be inviting a lawsuit for sure. I like the essence of the idea, but it’s probably more trouble than it’s worth for all but the most fanatic.

      • Olgratin_Magmatoe@slrpnk.net
        link
        fedilink
        English
        arrow-up
        3
        ·
        58 minutes ago

        Might be easiest to set up an instance in a country that doesn’t give a fuck about western IP law, then others can federate to it.

        So yeah, fanatic levels of effort.

  • K3CAN@lemmy.radio
    link
    fedilink
    English
    arrow-up
    1
    ·
    7 hours ago

    Can anyone figure out what the minimum process is to just use the SSG function? I’m having a really hard time trying to understand the documentation.

  • a1studmuffin@aussie.zone
    link
    fedilink
    English
    arrow-up
    44
    arrow-down
    1
    ·
    21 hours ago

    This seems especially handy for anyone who wants a snapshot of Reddit from pre-enshittification and AI era, where content was more authentic and less driven by bots and commercial manipulation of opinion. Just choose the cutoff date you want and stick with that dataset.

    • communism@lemmy.ml
      link
      fedilink
      English
      arrow-up
      18
      ·
      6 hours ago

      This is just an archive. No different from using the wayback machine or any other archive of web content.

  • breakingcups@lemmy.world
    link
    fedilink
    English
    arrow-up
    108
    arrow-down
    4
    ·
    1 day ago

    Just so you’re aware, it is very noticeable that you also used AI to help write this post and its use of language can throw a lot of people off.

    Not to detract from your project, which looks cool!

      • Melvin_Ferd@lemmy.world
        link
        fedilink
        English
        arrow-up
        11
        arrow-down
        37
        ·
        20 hours ago

        You’re awesome. AI is fun and there’s nothing wrong with using it especially how you did. Lemmy was hit hard with AI hate propaganda. China probably trying to stop it’s growth and development in other countries or some stupid shit like that. But you’re good. Fuck them

        • idealism_nearby@lemmy.world
          link
          fedilink
          English
          arrow-up
          29
          ·
          21 hours ago

          Would love to see you learn an entire foreign language just so you are able to communicate with the world without being laughed at by people as hostile as yourself.

          • potustheplant@feddit.nl
            link
            fedilink
            English
            arrow-up
            3
            arrow-down
            2
            ·
            3 hours ago

            They said it wasn’t their “first” lanugage. Which leads me to believe that they do speak English. If that’s the case, then they indeed are kind of lazy. There have already been studies in the impact of AI when used for communication and the results are not positive.

            This isn’t something I’d personally point out and criticize, just something I wouldn’t do personally. Take the time to express your own ideas in your own words. The long term cost is higher than the short term gains.

            • lad@programming.dev
              link
              fedilink
              English
              arrow-up
              2
              ·
              47 minutes ago

              I have A1 and A2 level in a couple of non-first languages, technically I can speak those, realistically I don’t and will not be able to communicate something more complex than ‘here, take a look’

              So I don’t agree with your absolutistic stance

        • MadMonkey@lemmy.world
          link
          fedilink
          English
          arrow-up
          15
          ·
          21 hours ago

          Brush, you do not seem like a nice person to be around.

          Spread love and kindness, not hate.

          I hope you have a better rest of your day.

  • frongt@lemmy.zip
    link
    fedilink
    English
    arrow-up
    50
    ·
    1 day ago

    And only a 3.28 TB database? Oh, because it’s compressed. Includes comments too, though.

      • muusemuuse@sh.itjust.works
        link
        fedilink
        English
        arrow-up
        10
        ·
        18 hours ago

        If only I had the space and bandwidth. I would host a mirror via Lemmy and drag the traffic away.

        Actually, isn’t the a way to decentralize this that can be accessed from regular browsers on the internet? Live content here, archive everywhere.

        • psycotica0@lemmy.ca
          link
          fedilink
          English
          arrow-up
          6
          ·
          14 hours ago

          Someone could format it into essentially static pages and publish it on IPFS. That would probably be the easiest “decentralized hosting” method that remains browsable

  • SteveCC@lemmy.world
    link
    fedilink
    English
    arrow-up
    34
    ·
    1 day ago

    Wow, great idea. So much useful information and discussion that users have contributed. Looking forward to checking this out.

  • 19-84@lemmy.dbzer0.comOP
    link
    fedilink
    English
    arrow-up
    25
    arrow-down
    2
    ·
    1 day ago

    PLEASE SHARE ON REDDIT!!! I have never had a reddit account and they will NOT let me post about this!!

    • Bazell@lemmy.zip
      link
      fedilink
      English
      arrow-up
      4
      ·
      12 hours ago

      We can’t share this on Reddit, but we can share this on other platforms. Basically, what you have done is you scraped tons of data for AI learning. Something like “create your own AI Redditor” . And greedy Reddit management will dislike it very much even if you will tell them that this is for the cultural inheritance. Your work is great anyway. Sadly, that I do not have enough free space to load and store all this data.

    • muusemuuse@sh.itjust.works
      link
      fedilink
      English
      arrow-up
      4
      ·
      18 hours ago

      You know what would be a good way to do t? Take all that content and throw it on a federated service like ours. Publicly visible. No bullshit. And no reason to visit Reddit to get that content. Take their traffic away.

        • muusemuuse@sh.itjust.works
          link
          fedilink
          English
          arrow-up
          1
          ·
          4 hours ago

          What would they say? It’s information that’s freely available, no payment required, no accounts to simply read it, no copyrights, where’s the legal in hosting a duplicate of the content?

  • Tanis Nikana@lemmy.world
    link
    fedilink
    English
    arrow-up
    29
    arrow-down
    2
    ·
    1 day ago

    Reddit is hot stinky garbage but can be useful for stuff like technical support and home maintenance.

    Voat and Ruqqus are straight-up misinformation and fascist propaganda, and if you excise them from your data set, your data will dramatically improve.