Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lpsm-dev/twitter-sentimental-analysis-covid
✔️ Twitter Sentimental Analysis Covid-19 (using Textblob - Naive bayes) + Python Backend Flask + Docker + Docker Compose + MongoDB
https://github.com/lpsm-dev/twitter-sentimental-analysis-covid
adminmongo alpine backend corona coronavirus-analysis covid covid-19 data-analysis docker docker-compose docker-compose-wait flask flask-restful mongodb mongoku python python-api sentiment-analysis twitter
Last synced: 3 months ago
JSON representation
✔️ Twitter Sentimental Analysis Covid-19 (using Textblob - Naive bayes) + Python Backend Flask + Docker + Docker Compose + MongoDB
- Host: GitHub
- URL: https://github.com/lpsm-dev/twitter-sentimental-analysis-covid
- Owner: lpsm-dev
- License: mit
- Created: 2020-03-15T17:56:34.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2024-09-17T19:06:44.000Z (5 months ago)
- Last Synced: 2024-09-17T23:34:13.067Z (4 months ago)
- Topics: adminmongo, alpine, backend, corona, coronavirus-analysis, covid, covid-19, data-analysis, docker, docker-compose, docker-compose-wait, flask, flask-restful, mongodb, mongoku, python, python-api, sentiment-analysis, twitter
- Language: Python
- Homepage:
- Size: 26.8 MB
- Stars: 5
- Watchers: 2
- Forks: 0
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
Welcome to Sentiment Analysis Repository
Python Sentiment Analysis API + Docker + Docker Compose### Menu
Pre-Requisites |
Description |
How to contribute### By me a coffe
Pull requests are welcome. If you'd like to support the work and buy me a ☕, I greatly appreciate it!
### Getting Started
If you want use this repository you need to make a **git clone**:
```bash
git clone --depth 1 https://github.com/lpmatos/sentiment-analysis.git -b master
```This will give access on your **local machine**.
### Pre-Requisites
To this project you yeed:
* Python 3.8.
* Docker and Docker Compose.
* MongoDB.### Built with
- [Python](https://www.python.org/)
- [MongoDB](https://www.mongodb.com/)
- [Mongoku](https://github.com/huggingface/Mongoku)
- [AdminMongo](https://github.com/mrvautin/adminMongo)
- [Docker](https://docs.docker.com/)
- [Docker Compose](https://docs.docker.com/compose/)### How to use it?
1. Set the gitlab environment variables.
2. Install python packages in requirements.txt.
2. Run this script with docker-compose, Dockerfile or into your local machine with Python command.
3. Profit.Press CTRL + C to stop it in Docker Compose or Dockerfile.
### Description
This is a project whose focus is to address the analysis of feelings in a basic way. An api was created to perform the search for tweets and as a result returns a list with the classification: positive, neutral, negative.
### Mongo Schema
![Alt text](docs/images/MONGO_SCHEMA.png?raw=true "Mongo Schema")
### Services
![Alt text](docs/images/SERVICES.png?raw=true "Services")
### Routes
![Alt text](docs/images/ROUTES.png?raw=true "Routes")
### Architecture
![Alt text](docs/images/ARCHITECTURE.png?raw=true "Architecture Sentimental Analysis")
### Results
![Alt text](docs/images/RESULTS.png?raw=true "Results Sentimental Analysis")
### Documentation
[Project Documentation](/docs/helper.md)
### MongoDB Tools
Some MongoDB Tools that we use in this project.
#### Mongoku
MongoDB client for the web. Query your data directly from your browser. You can host it locally, or anywhere else, for you and your team.
It scales with your data (at Hugging Face we use it on a 1TB+ cluster) and is blazing fast for all operations, including sort/skip/limit. Built on TypeScript/Node.js/Angular.
#### AdminMongo
AdminMongo is a cross platform user interface (GUI) to handle all your MongoDB connections/databases needs. AdminMongo is fully responsive and should work on a range of devices.
>
> AdminMongo connection information (including username/password) is stored unencrypted in a config file, it is not recommended to run this application on a production or public facing server without proper security considerations.
>### Environment variables
**Name** | **Description**
:---: | :---:
**TWITTER_CONSUMER_KEY** | Twitter Consumer Key
**TWITTER_CONSUMER_SECRET** | Twitter Consumer Secret
**TWITTER_ACCESS_TOKEN** | Twitter Access Token
**TWITTER_ACCESS_TOKEN_SECRET** | Twitter Access Token Secret
**LOG_PATH** | Just the Log Path
**LOG_FILE** | Just the Log File
**LOG_LEVEL** | Just the Log Level
**LOGGER_NAME** | Just the Logger name### 🐋 Development with Docker
Steps to build the Docker Image.
#### Build
```bash
docker image build -t -f
docker image build -t . (This context)
```#### Run
Steps to run the Docker Container.
* **Linux** running:
```bash
docker container run -d -p
docker container run -it --rm --name -p
```* **Windows** running:
```
winpty docker.exe container run -it --rm
```For more information, access the [Docker](https://docs.docker.com/) documentation or [this](docs/docker.md).
### 🐋 Development with Docker Compose
Build and run a docker-compose.
```bash
docker-compose up --build
```Down all services deployed by docker-compose.
```bash
docker-compose down
```Down all services and delete all images.
```bash
docker-compose down --rmi all
```### How to contribute
>
> 1. Make a **Fork**.
> 2. Follow the project organization.
> 3. Add the file to the appropriate level folder - If the folder does not exist, create according to the standard.
> 4. Make the **Commit**.
> 5. Open a **Pull Request**.
> 6. Wait for your pull request to be accepted.. 🚀
>
Remember: There is no bad code, there are different views/versions of solving the same problem. 😊### Add to git and push
You must send the project to your GitHub after the modifications
```bash
git add -f .
git commit -m "Added - Fixing somethings"
git push origin master
```👤 Hey!! If you like this project or if you find some bugs feel free to contact me in my channels:
>
> * Linktree: https://linktr.ee/lpmatos
>To check the change history, please access the [**CHANGELOG.md**](CHANGELOG.md) file.
This repository is a study project, therefore, it will not always be maintained 👻.
Give me a ⭐️ if this project helped you!
Made with 💜 by [me](https://github.com/lpmatos) 👋 inspired on [readme-md-generator](https://github.com/kefranabg/readme-md-generator)