A full-stack, beginner-friendly web application for visualizing global events on a 3D globe with sentiment analysis.
- 🌍 3D interactive Globe using
react-globe.gl - 🧠 Lightweight sentiment analysis using
TextBlob - 🤖 Simple query Chatbot
- 🔐 Secure JWT Authentication with SQLite
- ⚡ Fast backend with
FastAPI - 🎨 Modern UI with
Tailwind CSS v4
- Node.js (v18+)
- Python (v3.9+)
Open a terminal and run the following commands:
cd backend
pip install -r requirements.txt
python -m textblob.download_corpora # Needed for sentiment analysis
python -m uvicorn main:app --reloadThe backend will run on http://localhost:8000.
Open a new terminal and run:
cd frontend
npm install
npm run devThe frontend will run on http://localhost:5173. Open it in your browser.
- You will be greeted by the Login page. Click "Need an account? Sign up".
- Create a username and password. You will be automatically logged in.
- Interact with the 3D Globe:
- Green countries: Positive news
- Red countries: Negative news
- Blue countries: Neutral/No data
- Click on a country to see recent news and summarized sentiment.
- Click the Chat icon on the bottom right to ask questions.
- To use live Reddit data, you can extend
data_fetcher.pyand input PRAW credentials. - The project uses
sqlite3which automatically creates anews_dashboard.dbfile in yourbackendfolder.