AI-powered audience simulation to optimize your content before you publish
Features • Demo • Installation • Usage • Architecture • AI Integration • Contributing • Security • License
Sim-Fluence is a next-generation content testing platform that leverages agent-based simulation and social graph modeling to forecast how real-world audiences might respond to your content—before you share it. Whether you're a marketer, content creator, or business strategist, Sim-Fluence empowers you to optimize your messaging, design for virality, and uncover audience insights through AI-powered simulations.
Model thousands of unique AI agents with personalized personas, preferences, and social connections that mimic real audiences.
Estimate your content’s potential reach and viral performance using engagement simulations across diverse audience clusters.
Get feedback in the form of genuine-like comments, reactions, and suggestions—crafted by simulated agents mirroring your target demographics.
Visualize content propagation and peer-to-peer influence through social graph simulations, giving you insight into who shares and why.
Experience Sim-Fluence live: sim-fluence-demo.vercel.app
- Node.js (v18+)
- npm or yarn
- Git
- Google API Key for Gemini access
git clone https://github.com/your-username/sim-fluence.git
cd sim-fluence/Frontend
npm install # or yarn installCreate a .env file in the Frontend/ directory with:
NEXT_PUBLIC_API_URL=http://localhost:3001/api
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key
CLERK_SECRET_KEY=your_clerk_secret_key
GOOGLE_API_KEY=your_google_api_keynpm run dev # or yarn devcd ../Backend
npm install # or yarn installCreate a .env file in the Backend/ directory:
PORT=3001
DATABASE_URL=your_database_connection_string
JWT_SECRET=your_jwt_secret
GOOGLE_API_KEY=your_google_api_keynpm run dev # or yarn dev- Log in to your Sim-Fluence account
- Go to New Simulation
- Upload or enter your content
- Select audience demographics and behavior models
- Run the simulation
- Review metrics, feedback, and recommendations
- Engagement Score – Overall interaction level
- Virality Potential – Predicted shareability across networks
- Sentiment Breakdown – Agent sentiment toward the content
- Audience Segments – Reaction analysis by demographic groups
- Optimization Suggestions – Actionable AI-based improvements
- Next.js
- React
- TypeScript
- Tailwind CSS
- Clerk (authentication)
- Node.js + Express
- MongoDB / PostgreSQL
- Google Gemini API (for simulation and analysis)
- Frontend Hosting: Vercel
- Backend Deployment: Railway / Heroku
- CI/CD: GitHub Actions
Sim-Fluence leverages Google Gemini AI to:
- Craft detailed agent personas with individual biases and behaviors
- Simulate human-like responses across different content types
- Perform granular sentiment and intent analysis
- Identify amplification patterns and niche audience reactions
- Recommend data-driven optimizations
sim-fluence/
├── Frontend/ # Next.js frontend
│ ├── app/ # App routes
│ ├── components/ # UI components
│ ├── lib/ # Utilities
│ └── public/ # Static files
├── Backend/ # Express backend
│ ├── controllers/ # Route handlers
│ ├── models/ # MongoDB/PostgreSQL models
│ ├── routes/ # API endpoints
│ └── services/ # Core business logic
└── docs/ # Documentation and guides
RESTful API documentation available at api-docs.sim-fluence.com
Key Endpoints:
POST /api/simulations– Launch a new simulationGET /api/simulations/:id– Retrieve simulation outputGET /api/agents– View agent profilesPOST /api/feedback– Generate AI-based content feedback
We welcome developers, researchers, and creators to contribute!
- Fork the repository
- Create a feature branch:
git checkout -b feature/your-feature-name - Commit your changes:
git commit -m "Add: new feature" - Push your branch:
git push origin feature/your-feature-name - Submit a pull request 💠
Please refer to our Contributing Guide for more details.
Your data and privacy are our top priorities. If you discover a vulnerability, please refer to our Security Policy for responsible disclosure guidelines.
This project is open-source under the MIT License. See LICENSE for details.
For questions, ideas, or assistance, reach out at soumadityapal@outlook.com
- Google Gemini – for advanced AI capabilities
- Next.js – for powering our frontend
- Clerk – for seamless authentication
- Team Code for Change – for building this vision into reality
Made with ❤️ by Team Code for Change