SentiLog AI is an open-source platform that combines news sentiment analysis and personal mood journaling. It features a modern React frontend, a robust Node.js/Express backend, and a Python/Flask microservice for ML-powered sentiment/emotion analysis.
SentiLog AI provides a unique fusion of sentiment-aware news analysis and personal mental wellness tracking through the following key features:
- Automatically analyzes current news articles and classifies them based on political bias: Left, Right, or Neutral.
- Helps users recognize media bias and form balanced opinions.
- Uses Natural Language Processing (NLP) models to assess sentiment and ideological leaning in real-time.
- Users can write daily journal entries about their thoughts or experiences.
- The system performs sentiment and emotion analysis (e.g., happy, sad, anxious).
- Helps users track their mental state over time, identifying patterns or triggers.
- Journal data can be cross-referenced with consumed news to understand the impact of external events on personal emotions.
project-root/
│
├── client/ # React frontend (Vite + Tailwind)
│ └── src/
│ ├── pages/ # JournalPage, NewsPage, Dashboard
│ ├── components/ # Navbar, SentimentCard, ChartPanel
│ ├── App.jsx
│ └── main.jsx
│
├── server/ # Node.js + Express backend
│ ├── routes/ # journal.js, news.js
│ ├── controllers/
│ ├── models/ # Mongo schemas
│ └── index.js # Express entry
│
├── ml-api/ # Flask-based ML service
│ ├── app.py
│ ├── model/
│ └── requirements.txt
│
├── .gitignore
├── README.md
└── package.json / envs
git clone https://github.com/your-org/SentiLogAI.git
cd SentiLogAIcd client
npm install
npm run dev- Built with Vite + React + Tailwind CSS
- Main routes:
/journal,/news,/dashboard - Placeholder components:
Navbar,TextInput,SentimentCard,LineChart
cd ../server
npm install
npm run dev- Express.js API server
- Connects to MongoDB (see
.env.example) - Routes:
POST /api/journal/analyze→ calls ML APIPOST /api/news/analyze→ calls ML API
- Uses Mongoose for MongoDB schemas
cd ../ml-api
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python app.py- Flask microservice
/predictPOST endpoint: accepts{"text": "..."}and returns mock sentiment/emotion
- Copy
.env.exampleinserver/to.envand fill in your MongoDB URI and other secrets.
- Comment on the issue you want to work on (frontend, ml-api, express route, schema)
- Fork the repo & clone locally
- Work in the corresponding subfolder
- Open a PR with the title:
[Feature]: <Your Component or Route>
- Frontend: React, Vite, Tailwind CSS
- Backend: Node.js, Express, MongoDB, Mongoose
- ML API: Python, Flask, transformers, vaderSentiment
This project is licensed under the MIT License — see the LICENSE file for details.
The MIT License is a permissive license that allows you to:
- Freely use, copy, modify, and distribute the code.
- Use the project in commercial and non-commercial applications.
- Attribute the original creator(s) in any reused version.
By contributing to this repository, you agree that your contributions will be licensed under the MIT License as well.
Let's build the future of mood and news analysis together!
