Skip to content

init0-hack8/.github

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

7 Commits
Β 
Β 
Β 
Β 

Repository files navigation

Sensy

A Smart AI-powered Social Listening & Simulation Platform for Brands, Creators, and Analysts


🧠 What is init0-sentinel?

init0-sentinel is a multi-platform AI-powered post analysis and audience simulation tool built to help:

  • Brands πŸ“’
  • Influencers πŸŽ₯
  • Researchers πŸ“Š
  • Everyday users πŸ‘₯

...to understand how their post will perform before actually posting on major platforms like Instagram, Twitter (X), Threads, LinkedIn, etc.


🌐 Website Flow

πŸ” Authentication

  • Users log in via Google Authentication

🧾 Post Upload

  • Enter post content, attach image(s), and select platform(s)
  • Image is uploaded to Cloudinary
  • Post metadata is saved in Firestore

πŸ“Š Post Analysis

  • Once uploaded, users can navigate to the History page
  • There, users view analysis cards with post metadata and a "Get Full Insights" option

πŸ€– Custom AI Support & Prompt Engineering

While our current implementation uses Azure OpenAI (GPT) and Google Gemini models due to time constraints during Hack8, the system is fully modular β€” allowing integration with:

  • πŸ” Your own fine-tuned ML models
  • 🧠 HuggingFace Transformers
  • πŸ“¦ Local LLMs / REST APIs / Python-based sentiment classifiers

βš™οΈ The key strength lies in our high-level prompt engineering:

  • Not just asking vague questions β€” every prompt is structured to extract exact information like:

    • Engagement breakdown by age group
    • Seasonality relevance
    • Hashtag trends
    • Platform-specific response patterns
  • Outputs are well-structured, JSON-based, and ready for further analysis or visualization


πŸ”Ž What does the Analysis Include?

When analyzed, each post gives deep insights including:

  • Audience Segmentation
  • Sentiment Summary (Radar Chart)
  • Public Reactions
  • Platform-specific Behavior
  • Hashtag Popularity
  • Strategic Recommendations

... all derived using AI and web-scraped real-world reactions.


πŸ”„ Backend Flow (OpenAI + Gemini + Extendable)

All backend logic is handled under routes/index.js and flows as:

  1. πŸ” Post content sent to Azure OpenAI β†’ Extracts keywords & tones
  2. 🌐 Keywords passed to Gemini Grounding Search β†’ Web-scrapes user reactions, trending hashtags, etc.
  3. πŸ€– Scraped data returned to OpenAI β†’ Generates:
    • Audience breakdown
    • Engagement strategies
    • Sentiment analysis
    • Radar chart scores

πŸ“± PWA Social Simulation

To avoid relying on external paid or closed APIs (like Instagram API), we built our own PWA social media platform to simulate audience engagement.

PWA Features:

  • Users can post content
  • Others can:
    • ❀️ Like
    • πŸ’¬ Comment
    • 🎭 React with emojis
  • Post reactions feed into backend to refine future predictions

This provides pre-launch simulation of how a post might perform in real-world social media.


πŸ“¦ Repo Structure

init0-sentinel/
β”œβ”€β”€ Desktop-Client      # Electron or local desktop dashboard
β”œβ”€β”€ PWA-Client          # PWA-based social simulation app
β”œβ”€β”€ backend             # Node.js server with OpenAI/Gemini integration
β”œβ”€β”€ LICENSE
β”œβ”€β”€ README.md

✨ Tech Stack

  • Frontend: React (ShadCN, Tailwind), Vite
  • PWA: React PWA App with Firebase
  • Backend: Node.js, Express
  • Database: Firebase Firestore
  • AI Models: Azure OpenAI, Google Gemini (pluggable)
  • Image Hosting: Cloudinary

πŸ“Έ Screenshots

Dashboard

Screenshot 2025-04-16 233406

Post History Page

Screenshot 2025-04-16 234558

Analysis Page

Screenshot 2025-04-16 234257 Screenshot 2025-04-16 234523 Screenshot 2025-04-16 234544

PWA

feeds search profile trend


Built during Hack8 by a passionate group of developers who believe in intelligent, data-backed storytelling.


About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •