Meme Sentinel

Personal Memecoin Trend Detection Platform

Real-time intelligence platform that detects viral memes across TikTok and X/Twitter, correlates them with Solana memecoin launches on Pump.fun, and provides actionable trading signals through AI-powered analysis.

⚠️ PERSONAL USE ONLY: This is a private research tool for personal trading decisions. Not for distribution, commercial use, or financial advice.

---

🎯 What It Does

• Monitors TikTok and Twitter for viral trends in real-time
• Analyzes content using GPT-4o for sentiment, keywords, and memecoin potential
• Correlates viral trends with Solana token launches on Pump.fun
• Evaluates token health via on-chain analysis (wallet distribution, wash trading detection)
• Alerts you via Telegram and dashboard for high-potential opportunities

Goal: Reduce time between "meme goes viral" and "informed trading decision" from hours to seconds.

---

🚀 Quick Start

Prerequisites

• Bun 1.1 or later
• PostgreSQL 16+ (for production)
• Redis 7+ (for production)

Installation

# Install dependencies
bun install

# Start development server
bun run dev

Open http://localhost:3000 in your browser.

Development

# Run with hot reload
bun run dev

# Run in production mode
bun run src/index.ts

---

🏗️ Project Status

Current Phase: Early Development (MVP in progress)

Implemented:

• ✅ Basic Elysia server
• ✅ TypeScript configuration
• ✅ Project structure

In Progress:

• 🚧 Database schema and migrations
• 🚧 Worker integrations (TikTok, Twitter, Pump.fun)
• 🚧 AI analysis service
• 🚧 Correlation engine
• 🚧 Alert system
• 🚧 Dashboard UI

See docs/spec.md for detailed roadmap and architecture.

---

🛠️ Tech Stack

Layer	Technology
Runtime	Bun 1.1+
Framework	Elysia (type-safe, Bun-native)
Language	TypeScript 5.3+
Database	PostgreSQL 16 with Drizzle ORM
Cache	Redis 7
Queue	BullMQ
AI	OpenAI GPT-4o
Frontend	React 19 + Vite + Tailwind CSS

---

📁 Project Structure

meme-sentinel/
├── src/
│   ├── index.ts              # Elysia server entry point
│   ├── db/                   # Database schema and migrations
│   │   └── schema.ts
│   ├── services/             # Business logic
│   │   ├── trend.service.ts
│   │   ├── token.service.ts
│   │   ├── correlation.service.ts
│   │   ├── analysis.service.ts
│   │   └── alert.service.ts
│   ├── workers/              # Data ingestion workers
│   │   ├── tiktok/
│   │   ├── twitter/
│   │   └── pumpfun/
│   ├── routes/               # API endpoints
│   │   ├── trends.ts
│   │   ├── tokens.ts
│   │   └── alerts.ts
│   └── lib/                  # Utilities
├── docs/
│   └── spec.md               # Full technical specification
├── CLAUDE.md                 # AI assistant guidance
├── package.json
└── tsconfig.json

---

🔑 Environment Variables

Create a .env file in the root directory:

# Database
DATABASE_URL=postgresql://user:pass@localhost:5432/memesentinel
REDIS_URL=redis://localhost:6379

# API Keys
OPENAI_API_KEY=sk-...
TIKTOK_API_KEY=...
TWITTER_API_KEY=...
PUMPFUN_APIFY_TOKEN=...
BITQUERY_API_KEY=...

# Telegram (Personal)
TELEGRAM_BOT_TOKEN=...
TELEGRAM_CHAT_ID=...

# Server
PORT=3000
NODE_ENV=development

---

📊 Architecture Overview

┌─────────────────────────────────────────┐
│         INGESTION WORKERS               │
│  TikTok | Twitter | Pump.fun            │
└─────────────┬───────────────────────────┘
              │
              ▼
┌─────────────────────────────────────────┐
│         DATA LAYER                      │
│  PostgreSQL | Redis                     │
└─────────────┬───────────────────────────┘
              │
              ▼
┌─────────────────────────────────────────┐
│         SERVICE LAYER                   │
│  Trend | Token | Correlation | Analysis │
└─────────────┬───────────────────────────┘
              │
              ▼
┌─────────────────────────────────────────┐
│         API LAYER (Elysia)              │
│  /api/trends | /api/tokens             │
└─────────────┬───────────────────────────┘
              │
              ▼
┌─────────────────────────────────────────┐
│         CLIENTS                         │
│  Dashboard | Telegram | Mobile         │
└─────────────────────────────────────────┘

---

🎓 Key Concepts

Trend Analysis

Viral content is scored on three dimensions:

• Virality (35%): View velocity, creator count, engagement rate
• Token Potential (40%): GPT-4o assessment of memecoin viability
• Timing (25%): Freshness factor (decays over time)

Token Health Analysis

On-chain metrics evaluated:

• Wallet Distribution: Dev holdings, top 10 concentration
• Volume Quality: Wash trading detection via buyer/seller patterns
• Liquidity Health: Bonding curve progress, market depth
• Social Signals: Website, Twitter, Telegram presence

Correlation Engine

Matches trends to tokens using:

• Keyword matching (quick filter)
• GPT-4o semantic analysis (deep matching)
• Confidence scoring (0-1 scale)
• Match types: exact, semantic, related

---

📖 Documentation

• Full Specification: See docs/spec.md for complete architecture, database schema, API specs, and development roadmap
• AI Assistant Guide: See CLAUDE.md for guidance when working with Claude Code

---

⚠️ Important Disclaimers

Trading Risk:

• NOT financial advice
• Memecoin trading is extremely high risk
• Most memecoins go to zero
• Past performance doesn't indicate future results
• Always DYOR (Do Your Own Research)

Privacy & Security:

• Keep API keys secure and never commit them
• This tool has NO authentication - for personal use only
• Never share deployment URLs publicly
• Regular security updates required

Legal:

• Personal research tool only
• Not for commercial use or redistribution
• Complies with external API Terms of Service
• No warranties or guarantees on accuracy

---

📝 License

This project is for personal use only. Not licensed for distribution or commercial use.

---

🔗 Resources

• Bun Documentation
• Elysia Documentation
• Drizzle ORM
• Pump.fun

---

Version: 1.0.50 Last Updated: January 2026 Status: In Development