Real Feels

Real Feels is a program that records your speech and analyzes your emotions. Our goal is that the program will analyze not only words, but tone of voice and context in order to perform sentiment analysis. Based on this analysis, it can then recommend ways to make you feel better. In addition, Real Feels acts like a mental-health tracker that can give people detailed reports of their day-to-day mental state. This project is a work-in-progress and many features are yet to be implemented. This is an open-source project, and we encourage contributions and redistributions.

Current Features:

  • Capturing audio and running basic sentiment analysis
  • Desktop GUI

Features in Progress:

  • Recommendation system for music, movies, etc. based on perceived emotions
  • Recording history of emotion over a short period
  • Frequency and tone analysis with wav files. This is an experiemental feature. All files are currently in the tone-analysis folder and disjoint from the rest of the project.

Known Issues

  • Desktop GUI and tone analysis programs are not yet integrated with the back-end system.

How to Use

Sentiment Analysis

Audio Tone Analysis

Note: This program is currently a separate feature, and it is not implemented in Real Feels yet.

  • Capture audio from a microphone, making sure that it's a single-channel (mono) wav file.
  • Follow the instructions in tone-analysis/ to perform a Fast Fourier Transform on the wav file.

Contributor Guide

If you would like to contribute to [Project Name], please read the file


This project is distributed with the GNU General Public License Version 3. Please see the file LICENSE.txt.

Share this project: