Wavefront-ai

Onchain market intelligence for Solana — narrative clustering, risk scoring, and AI-powered token analysis in one terminal.

---

Overview

Wavefront transforms raw Solana market data into structured, actionable intelligence. Instead of displaying token lists, it clusters what is moving into human-readable narratives, filters out low-liquidity scams algorithmically, and routes deep token metadata directly into a Gemini-powered analyst — so traders get signal, not noise.

Built for the Birdeye Data BIP Competition.

Read the deep dive → docs/ARTICLE.md

---

Features

• Narrative Clustering — Parses Birdeye data points to surface emerging themes (AI Infrastructure, DePIN, RWA) before they trend on social media
• Risk Scorer — Mathematically penalizes zero-liquidity tokens; scams and honeypots are automatically graded F and filtered out
• AI Copilot — A Gemini-backed analyst pre-loaded with live holder concentration, freeze-authority status, and liquidity metrics for any token you inspect

---

Tech Stack

Layer	Technology
Framework	Next.js 16, React 19
Language	TypeScript 5
Styling	Tailwind CSS v4, Framer Motion
AI	Google Gemini (@google/genai)
Data	Birdeye API
Charts	Recharts
Deployment	Vercel

---

Getting Started

Prerequisites

• Node.js 20+
• A Birdeye API key
• A Google Gemini API key

Installation

git clone https://github.com/Ghostiemoh/wavefront.git
cd wavefront
npm install

Environment Variables

Create a .env.local file in the project root:

Variable	Description
BIRDEYE_API_KEY_CHARTS	Birdeye API key for market data
GEMINI_API_KEY	Google Gemini API key for the AI Copilot

Run

npm run dev

---

License

MIT