Skip to content

Latest commit

 

History

52 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Fatma - Your Emotion Companion

Fatma Logo

A multilingual AI-powered web application that helps users explore and understand their emotions through interactive conversation using natural language processing.

AI-Powered Emotion Detection

Fatma uses sophisticated natural language processing techniques to:

  • Detect emotional states from user input
  • Identify action verbs associated with specific emotions
  • Generate context-aware responses based on emotional patterns
  • Provide personalized insights through adaptive questioning

AI Features

  • Emotion Keyword Recognition: Direct mapping of verbs to emotional states
  • Contextual Understanding: Adaptive follow-up questions based on conversation history
  • Multilingual NLP: Emotion detection in German, English, and Turkish
  • Pattern Recognition: Identification of emotional clusters and themes

Features

  • Interactive AI chat interface with emotion detection
  • Multilingual support (German, English, Turkish)
  • Emoji-based emotion selection
  • Personalized emotion horoscope
  • Progress tracking through conversation
  • Real-time emotion analysis

Languages

  • 🇩🇪 German (index.html)
  • 🇺🇸 English (en.html)
  • 🇹🇷 Turkish (tr.html)

How to Use

  1. Open index.html in your web browser
  2. Start a conversation by typing your thoughts
  3. Select an emoji that represents your current emotional state
  4. Describe your feelings using action words
  5. Receive a personalized emotion horoscope

Development

The application uses JavaScript, HTML, and CSS. No external dependencies are required.

Flowchart

Flowchart of Fatma

Color Legend

  • Light Blue - User interactions (selection, input, processing)
  • Pink - Decision points (user choices, language selection)
  • Light Green - System processes (messages, language switching)

Adding New Languages

  1. Create a new HTML file (e.g., fr.html for French)
  2. Add translations to textContent in app.js
  3. Add emotion data to emotionData in emotions.js
  4. Update the language switcher in all HTML files

Demo

Click here to try out: Fatma Demo

License

This project is licensed under the MIT License - see the LICENSE file for details.

Citation

If you use this software for your research, please cite it using the DOI:

APA Format (7th Ed.):

Bilgin, M. (2025). Let's talk about feelings. Let's grow with Fatma. (Version 1.0.0) [Computer software]. Zenodo. https://doi.org/10.5281/zenodo.17635230

BibTeX:

@software{fatma-emotion-companion,
  author       = {Bilgin, Mustafa},
  title        = {Let's talk about feelings. Let's grow with Fatma.},
  year         = {2025},
  publisher    = {Zenodo},
  version      = {1.0.0},
  doi          = {10.5281/zenodo.17635230},
  url          = {https://doi.org/10.5281/zenodo.17635230}  
}

Dedication

This project is dedicated to my grandmother Fatma, who has always been like a mysterious Oghuz shaman to me – wise and deeply connected to her inner emotional world. Her charisma has inspired the heart of this companion.

About

A multilingual web application that helps users explore and understand their emotions through interactive conversation.

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages