Automated Research Partner for Content Creators

Built for KnowCode 3.0 '26

TrendForge is an AI-powered platform that solves content fatigue by scanning high-signal data streams (Google Trends, Reddit, X) to pinpoint emerging viral patterns and deliver actionable Content Blueprints.

Creators shouldn't spend hours scrolling just to stay relevant. TrendForge bridges the gap between massive data noise and creator productivity by:

• 📊 Scanning Google Trends, Reddit, and X for emerging viral patterns
• 🤖 Using AI-driven insights to translate raw data into Content Blueprints
• ⚡ Delivering insights through a high-performance React dashboard
• 📈 Providing data-backed roadmaps that turn social media chaos into actionable growth

• Framework: FastAPI (Python)
• Database: PostgreSQL + TimescaleDB (time-series tracking)
• Cache: Redis
• Data Sources: Google Trends API, Reddit API (PRAW), Twitter/X API (Tweepy)
• AI/LLM: OpenAI / Groq
• Auth: Supabase

• Framework: React + Vite
• Routing: React Router
• Charts: Recharts
• HTTP Client: Axios
• Auth: Supabase JS Client
• Deployment: Vercel

• Python 3.9+
• Node.js 18+
• PostgreSQL with TimescaleDB extension
• Redis server
• API Keys: OpenAI/Groq, Reddit, Twitter/X, Supabase

1. Navigate to backend directory

   cd backend

2. Create and activate virtual environment

   # Windows
   python -m venv venv
   venv\Scripts\activate
   
   # macOS/Linux
   python3 -m venv venv
   source venv/bin/activate

3. Install dependencies

   pip install -r requirements.txt

4. Configure environment variables

   cp .env.example .env
   # Edit .env with your API keys and database credentials

5. Run the development server

   python main.py
   # Or use uvicorn directly:
   uvicorn main:app --reload --host 0.0.0.0 --port 8000

   Backend will be available at: http://localhost:8000 API docs: http://localhost:8000/docs

1. Navigate to frontend directory

   cd frontend

2. Install dependencies

   npm install

3. Configure environment variables

   cp .env.example .env
   # Edit .env with your API endpoint and Supabase credentials

4. Run the development server

   npm run dev

   Frontend will be available at: http://localhost:5173

trendforge/
├── backend/                 # FastAPI Backend
│   ├── main.py             # Application entry point
│   ├── requirements.txt    # Python dependencies
│   ├── .env.example        # Environment variables template
│   └── .gitignore
│
├── frontend/               # React Frontend
│   ├── src/
│   ├── package.json
│   ├── vite.config.js
│   ├── .env.example
│   └── .gitignore
│
└── README.md              # This file

DATABASE_URL=postgresql://user:password@localhost:5432/trendforge
REDIS_URL=redis://localhost:6379/0
OPENAI_API_KEY=your_openai_api_key
GROQ_API_KEY=your_groq_api_key
REDDIT_CLIENT_ID=your_reddit_client_id
REDDIT_CLIENT_SECRET=your_reddit_client_secret
TWITTER_BEARER_TOKEN=your_twitter_bearer_token
SUPABASE_URL=your_supabase_url
SUPABASE_KEY=your_supabase_key
SECRET_KEY=your_secret_key_here

VITE_API_URL=http://localhost:8000
VITE_SUPABASE_URL=your_supabase_url
VITE_SUPABASE_ANON_KEY=your_supabase_anon_key

• Freemium: Basic trend discovery and limited insights (free)
• Premium: Niche-specific trends, trend lifespan prediction, detailed platform-wise recommendations (monthly subscription)
• Team Plans: For agencies and brands managing multiple creators (future)

# Run tests
pytest

# Format code
black .

# Lint code
flake8 .

# Build for production
npm run build

# Preview production build
npm run preview

Once the backend is running, visit:

• Swagger UI: http://localhost:8000/docs
• ReDoc: http://localhost:8000/redoc

This project is being developed for KnowCode 3.0 '26 hackathon.

TBD

Built with ❤️ for creators who deserve better tools