Skip to content

developerlee79/blue_cats

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Whiplash

A more affordable, more understanding, and sovereign decentralized AI marketing solution

(built for the BuidlAI 2025 Hackathon)


How to run

BackEnd & Database

Build and run the BackEnd & Database application stack using Docker Compose:

docker compose up -d --build

FrontEnd

Run the following commands to start the Frontend demo:

cd /bluecats_fe
yarn install
yarn start

Then open your browser and navigate to:

http://localhost:3000


AI Agent

The deployed NEAR AI Agent can be accessed at the following URL:

https://app.near.ai/agents/redsite5429.near/bluecats_agent/latest


Environment File

Add your API key to the .env file, using the provided example as a reference.


Architecture Overview

1

Collection and Refinement of Latest Community-Driven Trend Data

To collect up-to-date trend data for marketing purposes, an automated crawling agent periodically scrapes high-velocity trend sources such as Reddit and X (formerly Twitter).

The raw data is then processed and enriched using Upstage LLM-based models, which extract semantic context, including key topics and relevant keywords, transforming it into structured JSON-ready format.

The structured output is persisted in a PostgreSQL database and serves as the core dataset for context-aware, personalized marketing solutions.

2

Web3 Wallet Authentication System & Document-based user context profiling (services and companies) for tailored marketing recommendations

Privacy-preserving wallet login enables users to access business services without exposing any personally identifiable information (PII), ensuring both anonymity and secure authentication.

Using Upstage's information-extract AI model, the system analyzes user-submitted service documents (e.g., whitepapers, websites, and related materials) to extract user background and contextual metadata.

This contextual understanding is then used to generate personalized marketing data tailored to each user's domain and service characteristics.

3

Providing Personalized Marketing Solutions by Integrating User Context with the Latest Trend Data Using LLM-Powered AI Agent

This system uses an LLM AI Agent deployed on NEAR.AI to generate personalized marketing outputs by combining:

User context, extracted from submitted documents (e.g., whitepapers, service descriptions) using Upstage's information-extract model

Real-time trend data, crawled from online communities like Reddit and X

The AI Agent matches semantic elements from both sources — such as service domain, product focus, and trend topics — to produce structured data that can be used in context-aware marketing workflows.

Future Development Roadmap

Multi-Platform Trend Collection

Currently, the trend data pipeline relies solely on Reddit. In future iterations, we plan to extend our crawling infrastructure to support additional platforms such as X (formerly Twitter) and other high-signal online communities, to broaden the scope and diversity of trend sources.

Advanced Trend Intelligence Features

Beyond presenting raw trend data, we aim to develop features that help content marketers and strategists better understand the lifecycle and origin of each trend. Planned capabilities include:

  • Estimating trend longevity and saturation
  • Identifying original sources and propagation paths
  • Providing automated research summaries for deeper insight

These enhancements are designed to support data-driven creative decisions, especially for teams that require context-aware content direction and timely market insights.

About

A more affordable, more understanding, and sovereign decentralized AI marketing solution

Resources

Stars

Watchers

Forks