Daily Train

Daily Train is a personalized news platform built around worldview-aware reporting.

Users begin with a Political Preferences Personality Test that identifies how they interpret political and social issues. Based on the selected values, the platform generates a corresponding worldview profile and uses that profile to drive personalized news delivery.

Product Concept

• Entry point: a values-based survey ("Political Preferences Personality Test")
• Core output: worldview profile pages (with distinct editorial framing)
• Personalization loop: subscriber-specific agents process incoming news using the subscriber's worldview profile
• Delivery: recurring personalized updates for subscribed users

This architecture creates a consistent lens between user preferences and the tone/framing of the news they receive.

Repository Structure

• web/ - WordPress site and theme code powering the primary product experience
• news/ - Python processing scripts for subscriber pipelines and content generation/delivery
• mobile/ - Mobile app surface and integration layer for subscriber experiences
• bloke/ - Supporting service/runtime scripts
• shared/ - Cross-surface shared assets and utilities
• internal/ - Internal supporting code and tooling

How the System Works

1. A user completes the political preferences survey.
2. The system maps selected values into a worldview profile.
3. A profile page is created/reused for that worldview.
4. Subscriber workflows in news/ process current news through that worldview.
5. Personalized outputs are delivered to subscribers.

Web Theme Setup

The main front-end experience runs through the child theme in:

• web/wp-content/themes/daily-train

For fresh-install setup details (required pages, configuration, secrets, and custom tables), see:

• web/wp-content/themes/daily-train/SETUP.md

Quick Start

This project is functional but requires environment setup (API keys, WordPress data model, and custom tables) before full workflows are available.

Minimum path to get oriented:

1. Stand up WordPress and activate the daily-train child theme under web/wp-content/themes/daily-train.
2. Configure required pages/slugs, secrets, and custom tables using web/wp-content/themes/daily-train/SETUP.md.
3. Run and inspect the content processing scripts in news/ to understand subscriber delivery workflows.
4. Optionally wire the mobile/ app for end-to-end testing of mobile-linked subscriber flows.

Project Maturity

• Core personalization flow is implemented and working.
• Fresh-install compatibility has been improved, but setup still requires manual environment-specific configuration.
• Future work is primarily around robustness, observability, and stronger event understanding quality.

Vision

Daily Train explores a practical question:

What if people could follow the same events through a worldview that actually matches how they think?

The current implementation is strong in personalization and content generation flow, with ongoing opportunities to improve robustness and event understanding over time.