Skip to content

MrSJx/Audience

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

5 Commits
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🎭 Audience

Know how the world reacts β€” before you post.

Status License Model Made With


πŸ“Œ What is Audience?

Audience is an open-source AI platform that simulates how a real audience would react to your content β€” before you upload it anywhere.

Upload a video, image, audio file, animation, or artwork. Choose your target platform. Get a full Audience Reaction Report β€” with emotion scores, peak moment timestamps, dopamine hit detection, simulated comments, and a demographic breakdown of who will love it and who will scroll past.

No sugarcoating. No empty praise. Just honest, data-driven feedback from a simulated crowd.


✨ Features

  • πŸŽ₯ Multi-media support β€” Video, Image, Audio, Animation, Artwork
  • πŸ“± Platform-aware analysis β€” Tune reactions for Instagram, YouTube, TikTok, and more
  • ⚑ Peak Moment Detection β€” Timestamps of when your audience spikes or drops off
  • πŸ“Š Emotion Score Dashboard β€” Interest, Excitement, Happiness, Dopamine Hit, Boring Rate
  • πŸ’¬ Simulated Comment Section β€” Real-feeling comments, arguments included
  • πŸ‘₯ Demographic Breakdown β€” Age groups, gender perception, regional/cultural flags
  • πŸ” Honest Critique β€” Actionable feedback with no sugarcoating
  • πŸ† Final Verdict + Performance Prediction β€” Viral potential, retention rate, share likelihood

πŸ–ΌοΈ Example Output

πŸ“Š AUDIENCE REACTION REPORT
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🎯 Content Summary:
A 30-second Instagram Reel featuring fast-cut dark humor about
Monday mornings. Strong hook, slow middle, punchy ending.

⚑ Peak Moments:
πŸ”₯ [0:04] Opening hook lands hard β†’ Immediate interest spike
πŸ”₯ [0:18] Dark humor punchline β†’ Dopamine hit expected
😐 [0:11] Slow transition β†’ Possible scroll-away zone

πŸ“ˆ Emotion Scores:
Interest Score         β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–‘β–‘  78/100
Excitement Score       β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–‘β–‘β–‘  68/100
Happiness Score        β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–‘β–‘  75/100
Boring Rate            β–ˆβ–ˆβ–ˆβ–‘β–‘β–‘β–‘β–‘β–‘β–‘  28/100
Dopamine Hit Score     β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–‘β–‘  80/100
Re-watch Potential     β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–‘β–‘β–‘  70/100

πŸ’¬ Simulated Comments (Instagram):
@user_98x: bro the timing at 0:18 was PERFECT πŸ’€
@reel_critic: first 5 seconds almost lost me ngl
@darkhumorfan: no because why is this so accurate πŸ’€
@just_scrolling99: i've watched this 4 times already why
@real_talk_22: the editing in the middle dragged a bit

πŸ† Final Verdict:
"Strong hook, shaky middle, great ending β€” one edit away from viral."

πŸ“Š Predicted Performance on Instagram Reels:
Viral Potential    β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–‘β–‘β–‘β–‘  62%
Retention Rate     β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–‘β–‘β–‘β–‘β–‘  50%
Share Likelihood   β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–‘β–‘β–‘  72%

πŸ› οΈ Tech Stack

Layer Technology
AI Model Meta Tribe V2
Backend Python
Frontend (Coming soon)
License MIT (Non-Commercial)

πŸš€ Getting Started

⚠️ This project is currently in early development. Full setup instructions will be added as the project progresses.

Prerequisites

  • Python 3.10 or above
  • Git installed on your machine
  • Basic understanding of running terminal commands

Installation

# 1. Clone the repository
git clone https://github.com/YOUR_USERNAME/audience.git

# 2. Navigate into the project folder
cd audience

# 3. Install dependencies (once requirements.txt is added)
pip install -r requirements.txt

# 4. Run the app
python main.py

Full setup guide will be added in the /docs folder as development progresses.


πŸ“ Project Structure

audience/
β”‚
β”œβ”€β”€ backend/          β†’ Core AI logic and API integration
β”œβ”€β”€ frontend/         β†’ User interface
β”œβ”€β”€ docs/             β†’ Documentation and guides
β”œβ”€β”€ .gitignore
β”œβ”€β”€ LICENSE
└── README.md

βš–οΈ License & Legal

This project is released under the MIT License for open-source and educational use.

Important: This project uses Meta Tribe V2, which is governed by Meta's non-commercial license. Therefore, this project may not be used for any commercial purpose. It is strictly a learning and open-source initiative.

See the LICENSE file for full details.


πŸ™Œ Contributing

We are beginners learning as we build β€” and we welcome everyone at any skill level!

If you have ideas, bug reports, or want to contribute code:

  1. Fork this repo
  2. Create a new branch (git checkout -b feature/your-idea)
  3. Commit your changes
  4. Open a Pull Request β€” describe what you changed and why

You can also open an Issue or start a Discussion if you have questions or suggestions.


πŸ‘₯ Team

Built with curiosity and zero prior AI/ML experience β€” learning in public, one commit at a time.


🎭 Audience β€” Simulating the crowd so you don't have to guess.