SocioSential is an open-source OSINT intelligence framework designed to map the pulse of digital societies in real time.
It collects and analyzes public social data to uncover emotional patterns, behavioral anomalies, and shifting sentiment across communities and networks.
By transforming raw social signals into structured insight, SocioSential enables researchers, analysts, and security professionals to detect emerging narratives, monitor socio-political trends, and make informed, data-driven decisions. 🚀
Tip
- 🚀 Visit the Blog (Geo Sentinel Updates & Insights) [🌐 Open Blog]
- 🚀 Official Website [🌍 Visit Site]
- 🚀 Official Website [🌍 Visit Site]
Caution
- 🚨 SocioSential — Stay updated with the latest Socio Sentinel AI releases and announcements. [📝 Subscribe Here]
- SociSentail currently supports Twitter and Reddit OSINT, behavioral and sentiment analysis. Additional other social media intelligence modules and features are actively under development.
- 📡 Real-time social data aggregation
- 🧠 Sentiment and behavioral analysis
- 🌐 Community and network mapping
- 🔍 Detection of anomalies and trend shifts
- 📊 Actionable socio-political intelligence
- Social sentiment monitoring
- Narrative and influence tracking
- OSINT investigations
- Behavioral analysis of online communities and the user.
- Early detection of socio-political shifts
👉 https://github.com/h9zdev/SocioSential
- Python 3.8+
- Redis (for Celery background tasks)
- API Keys for social platforms and AI providers (optional but recommended)
-
Clone the repository:
git clone https://github.com/h9zdev/SocioSential.git cd SocioSential -
Create a virtual environment:
python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate
-
Install dependencies:
pip install -r requirements.txt
-
Initialize the database: The application uses SQLite and will automatically initialize
socio.dbon first run.
Create a .env file in the root directory or set the following environment variables:
# Flask Configuration
FLASK_SECRET_KEY=your_secret_key_here
# Celery / Redis Configuration
CELERY_BROKER_URL=redis://localhost:6379/0
CELERY_RESULT_BACKEND=redis://localhost:6379/0
# Twitter API (v2)
TWITTER_BEARER_TOKEN=your_bearer_token
# AI Provider Keys
OPENAI_API_KEY=your_openai_key
HF_TOKEN=your_huggingface_token
OPENROUTER_API_KEY=your_openrouter_key
OLLAMA_BASE_URL=http://localhost:11434
# Discord Integration
DISCORD_WEBHOOK_URL=your_webhook_url
DISCORD_BOT_TOKEN=your_bot_token
DISCORD_CHANNEL_ID=your_target_channel_id
# Database
SOCIO_DB_FILE=socio.dbpython Socio.pyThe application will be available at http://127.0.0.1:5000.
celery -A Socio.celery worker --loglevel=infopython bot.py-need to config api's in Socio.py, bot.py and reddit.py
- Dashboard: Access the main interface to navigate between Twitter and Reddit modules.
- Twitter OSINT: Enter a username to perform reconnaissance. Use the "Neural" tab for AI analysis.
- Reddit OSINT: Search for users or subreddits. Establish "Surveillance" to receive automated alerts on threat spikes.
- Monitoring: View active monitors in the Reddit Surveillance tab to track threat scores over time.
- Exports: Generate PDF reports of your findings for professional documentation.
This tool is for educational and professional research purposes only. Users are responsible for complying with the Terms of Service of the social platforms accessed and all applicable local and international laws.
This project is licensed under the Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0) License. See the LICENSE file for more details.
Unauthorized use is strictly prohibited.
📧 Contact: singularat@protn.me
Donate via Monero: 45PU6txuLxtFFcVP95qT2xXdg7eZzPsqFfbtZp5HTjLbPquDAugBKNSh1bJ76qmAWNGMBCKk4R1UCYqXxYwYfP2wTggZNhq
X9 CYBERNETICS
Made with ❤️ and lots of ☕️.