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
    50
    arrow-down
    1
    ·
    22 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
      17
      ·
      11 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.

      • floquant@lemmy.dbzer0.com
        link
        fedilink
        English
        arrow-up
        3
        ·
        edit-2
        6 hours ago

        Is it though? That is (or was, and should be again) publicly accessible information that was created over the years by random internet users. I refuse the notion that an American company can “own it” just because they ran the servers. Sure they can hold copyright for their frontend and backend code, name and whatever. But posts and comments, no way.

        Of course it would be dumb for someone under US jurisdiction but we’ll see how much an international DMCA claim is worth considering the current relations anyway.

        • TeddE@lemmy.world
          link
          fedilink
          English
          arrow-up
          1
          ·
          4 hours ago

          They don’t own it, the individual posters own the content of their own posts, however, from the reddit terms of service:

          When Your Content is created with or submitted to the Services, you grant us a worldwide, royalty-free, perpetual, irrevocable, non-exclusive, transferable, and sublicensable license to use, copy, modify, adapt, prepare derivative works of, distribute, store, perform, and display Your Content and any name, username, voice, or likeness provided in connection with Your Content in all media formats and channels now known or later developed anywhere in the world. This license includes the right for us to make Your Content available for syndication, broadcast, distribution, or publication by other companies, organizations, or individuals who partner with Reddit.

          And with each of those rights granted, Reddit’s lawyers can defend those rights. So no, they don’t own it “just because they ran the servers” - they own specific rights to copy granted to them by each poster.

          (I don’t like this arrangement, but ignorance of the terms of service isn’t going to help someone who uploaded a full copy of the works they have extensive rights to) On this subject I think there needs to be an extensive overhaul to narrow what terms you can extend to the general public. The problem is I straight up don’t trust anyone currently in power to make such a change to have our interests in mind.

      • Olgratin_Magmatoe@slrpnk.net
        link
        fedilink
        English
        arrow-up
        4
        ·
        edit-2
        10 hours 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.

          • Buddahriffic@lemmy.world
            link
            fedilink
            English
            arrow-up
            2
            ·
            edit-2
            5 hours ago

            They might have set up the user agreement for it. Stackexchange did and their whole business model was about catching businesses where some worker copy/pasted code from a stackexchange answer and getting a settlement out of it.

            I agree with you in principle (hell, I’d even take it further and think only trademarks should be protected, other than maybe a short period for copyright and patent protection, like a few years), but the legal system might disagree.

            Edit: I’d also make trademarks non-transferrable and apply to individuals rather than corporations, so they can go back to representing quality rather than business decisions. Especially when some new entity that never had any relation to the original trademark user just throws some money at them or their estate to buy the trust associated with the trademark.

          • Olgratin_Magmatoe@slrpnk.net
            link
            fedilink
            English
            arrow-up
            1
            ·
            edit-2
            4 hours ago

            /u/Buddahriffic put it better than I could.

            I agree, it shouldn’t be reddit’s intellectual property. But the law binds the poor and protects the rich.

  • a1studmuffin@aussie.zone
    link
    fedilink
    English
    arrow-up
    50
    arrow-down
    1
    ·
    1 day 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.

  • breakingcups@lemmy.world
    link
    fedilink
    English
    arrow-up
    120
    arrow-down
    4
    ·
    2 days 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
        16
        arrow-down
        47
        ·
        1 day 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

        • rumba@lemmy.zip
          link
          fedilink
          English
          arrow-up
          4
          arrow-down
          1
          ·
          8 hours ago

          Yup, if there was ever a decent use for AI, this is it. Lemmy can (and will) hate the shit out of it, but it took a little burden off the shoulders of someone doing us a great service.

        • idealism_nearby@lemmy.world
          link
          fedilink
          English
          arrow-up
          33
          arrow-down
          1
          ·
          1 day 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
            2
            arrow-down
            7
            ·
            edit-2
            12 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.

            • rumba@lemmy.zip
              link
              fedilink
              English
              arrow-up
              3
              arrow-down
              1
              ·
              8 hours ago

              Hey I drove to the library, picked up all these things you needed, got dinner here ya go, free!

              You drove? man that’s lazy…

              He used AI to clean up translation and save time after he spent a fuck ton of time curating and delivering us a helpful product. Calling him out as lazy is an awful take.

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

                First, that’s an awful analogy.

                Second, you’re assuming (for some unknown reason) that they “cleaned up” the “translation” using ai. You have literally no idea exactly how they wrote the post. It’s kinda weird to make up a random scenario but ok.

                Third, no, it’s not an awful take. You can code something that requires a ton of effort but write awful documentation. One thing does not make the other impossible.

                Fourth, I already explained that there have already been studies that concluded that using AI to write stuff for you has a negative impact on your communication skills. This is not an opinion or me being ingrateful or whatever. I was just sharing information.

              • 19-84@lemmy.dbzer0.comOP
                link
                fedilink
                English
                arrow-up
                3
                arrow-down
                1
                ·
                7 hours ago

                there are the so called activists that complain alot then there are the activists that deliver projects and code… enough said

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

                  “Activists”? What are you even talking about?

                  Regardless, I specifically said that what you did wasn’t wrong or anything likw that. I simply think that it’s going to do you more harm than good in the long run. You’re free to do whatever you want though, obviously.

                  Another piece of advice. When someone simply shares an opinion, don’t get instantly butthurt over nothing. Otherwise this might as well be reddit.

            • lad@programming.dev
              link
              fedilink
              English
              arrow-up
              3
              ·
              10 hours 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

              • potustheplant@feddit.nl
                link
                fedilink
                English
                arrow-up
                2
                ·
                1 hour ago

                There’s nothing “absolutistic” about my “stance”. If you’re rusty using a language, you won’t get better if someone else does the homework for you. Make an effort, make mistakes, write in a way that sounds weird, who cares. But practice. If you only take the easy way out, that’ll be your only option in the future.

                Although, like I already said, that’s MY way of thinking about it. If you want to use ai to write your stuff, you do you. It doesn’t negate the fact that, whle it’s not “wrong”, it’s the lazy (or minimum effort) option. Don’t know why it bothers you so much.

        • MadMonkey@lemmy.world
          link
          fedilink
          English
          arrow-up
          18
          ·
          1 day 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.

  • K3CAN@lemmy.radio
    link
    fedilink
    English
    arrow-up
    1
    ·
    16 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.

  • frongt@lemmy.zip
    link
    fedilink
    English
    arrow-up
    51
    ·
    2 days 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
        ·
        1 day 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
          ·
          23 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
    36
    ·
    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
      ·
      edit-2
      21 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.

  • Tanis Nikana@lemmy.world
    link
    fedilink
    English
    arrow-up
    30
    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.

    • muusemuuse@sh.itjust.works
      link
      fedilink
      English
      arrow-up
      4
      ·
      1 day 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
          ·
          13 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?

          • El Barto@lemmy.world
            link
            fedilink
            English
            arrow-up
            1
            ·
            19 minutes ago

            Oh I agree with you, friend. The problem is that they’ll say that they’re losing ad revenue. So they’ll try and sue, even if they’re in the wrong.

          • limelight79@lemmy.world
            link
            fedilink
            English
            arrow-up
            1
            ·
            7 hours ago

            It might fall under the same concept that recipes do - you can’t copyright a recipe, but a collection of recipes (such as a book) is copyrightable.

            In any case, they have a lot more money to pay lawyers than you or I do, I’ll bet, so even if you are right, that doesn’t mean you’ll have the money to actually win.