Skip to content

Odiethebest/Pulse

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

135 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Pulse

A multi-agent public opinion analysis system. Input any topic or event, and Pulse dispatches specialized AI agents to scrape, analyze, debate, and synthesize what the internet actually thinks.

When trending events break, most teams waste time doing manual tab switching across X and Reddit. Pulse is built to replace that workflow with one query and one defensible report.

What You Get

  1. A frontline verdict you can read in seconds.
  2. Cross-platform sentiment and camp split from X and Reddit.
  3. Controversy lenses with source-grounded quote cards.
  4. Confidence, heat, polarization, and flip risk signals.
  5. A live execution trace so the process is visible, not a black box.

Under the Hood in One Minute

  1. Query planner converts one topic into platform-specific retrieval strategy.
  2. Reddit and Twitter agents fetch raw public discussions in parallel.
  3. Analysis agents extract sentiment, stance, conflict, aspect, and flip-risk signals.
  4. Synthesis agent drafts the report and critic agent audits quality.
  5. If quality is weak, one guided rewrite runs before final output.

Quick Start

Local development:

cd backend
cp .env.example .env
./mvnw spring-boot:run

In another terminal:

cd frontend
npm install
npm run dev

Container build:

docker build -t pulse:latest .

Documentation

Product docs:

  1. Inspiration
  2. UIUX design
  3. Agent system design

Developer docs:

  1. Developer docs index
  2. Architecture and core logic
  3. API contract
  4. Design principles
  5. UIUX implementation guide
  6. Operations and maintenance
  7. Testing and quality

Built By

By Odie Yang.

Live demo: pulse.odieyang.com

More work: odieyang.com

About

A multi-agent public opinion analysis system. It scrapes Reddit & Twitter, analyzes sentiment, and uses a Critic-Synthesis debate loop to uncover what the internet actually thinks.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors