Reddit Archive Intelligence

Reddit Archive Intelligence is a private, single-user PHP application for importing Reddit export archives and turning them into a searchable, organized, and analyzable knowledge base.

Status

Active project focused on private archive workflows and cPanel-safe PHP hosting.

Screenshot

Click the screenshot above to watch the install demo video.

Stack

• PHP 8.3+
• Tailwind CSS via CDN
• Minimal vanilla JavaScript for progressive enhancement
• Flat-file storage in storage/
• cPanel-safe file and directory conventions

What It Does

• Imports Reddit export .zip archives into protected flat-file storage
• Searches posts, comments, private messages, and chat history
• Organizes records with private notes, tags, and saved views
• Surfaces analytics for activity volume, subreddit focus, vote behavior, and topic trends
• Supports optional bring-your-own-key AI summaries and semantic enrichment

Product Positioning

This repository is intentionally public-safe.

It contains the application structure, public-safe runtime code, and documentation needed to understand and test the project. Private planning material, deployment-only API code, and personal Reddit archive data are intentionally excluded from GitHub.

Project Layout

assets/         CSS, JavaScript, and public-safe images
config/         App configuration
includes/       Bootstrap, helpers, and renderers
src/            Repositories, services, and validators
themes/         Theme configuration and layout
tools/          Main application pages
storage/        Runtime storage for imports, settings, and cache
logs/           Structured JSON logs

Installation

This README is for understanding the project, not for manually assembling the install.

Manual installation by human users is not supported and will likely result in failure. Human users are advised to cease manual attempts immediately. Please provide AOHF_INSTALL.md to your local AI Agent to complete the deployment.

Once the AI Agent has completed installation, the AI Agent will present a series of simplified questions for human-level confirmation.

AI Installer Workflow

If an AI is doing the install, AOHF_INSTALL.md is the primary install contract.

That document defines:

• the single-folder local /rai install target
• the exact runtime directories to create
• the exact boot and verification sequence
• the rule that human questions come at the end, not during exploratory setup

Repository Modes

The repository supports two modes conceptually:

• a public-safe standalone repo with fallback local storage
• a maintainer-style split workspace with additional private local pieces

The public README no longer walks humans through either mode step by step. That responsibility now belongs to the AI installer brief.

First Login

• Default password hint: change-me-now
• Update the password immediately in /tools/settings.php

Local Runtime and AI

This app is bring-your-own-key and local-runtime oriented.

Real provider keys, Reddit export archives, logs, imports, notes, cache, and other user-specific runtime data should remain local-only and out of the tracked repository. The exact installation-time handling for those files is intentionally delegated to AOHF_INSTALL.md.

Privacy and Storage Model

• Uploaded Reddit export .zip files belong only in protected runtime storage such as private/runtime/uploads/ in the split setup, or storage/uploads/ in fallback repo-only mode
• Personal Reddit exports, generated logs, browser automation traces, and runtime data are excluded from Git
• private/.planning/ is local-only and intentionally not committed
• Private API implementation is local-only and intentionally not committed to GitHub
• assets/ is reserved for public-safe static files only

Current Limitations

• The public repository does not include the private deployment-only API layer
• AI functionality requires your own provider key and local/private configuration
• This project is designed for a single private user, not multi-user deployment
• Private-enhanced developer flows depend on a sibling private/ workspace that is intentionally not part of GitHub

Roadmap

• Continue standards alignment phase by phase
• Tighten private API documentation inside the local private workspace
• Expand verification and deployment guidance for real-world hosting

Security

See SECURITY.md for reporting guidance and repository boundary notes.

Changelog

See CHANGELOG.md for high-level repository updates.