Sa-m commited on
Commit
24a02b6
Β·
verified Β·
1 Parent(s): dde5be4

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +62 -2
README.md CHANGED
@@ -1,5 +1,5 @@
1
  ---
2
- title: Manifesto Explainer
3
  emoji: πŸ“ˆ
4
  colorFrom: blue
5
  colorTo: red
@@ -8,7 +8,67 @@ app_file: app.py
8
  pinned: true
9
  ---
10
 
11
- # Configuration
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
12
 
13
  `title`: _string_
14
  Display title for the Space
 
1
  ---
2
+ title: Manifesto Explainer with LLM Enhancement
3
  emoji: πŸ“ˆ
4
  colorFrom: blue
5
  colorTo: red
 
8
  pinned: true
9
  ---
10
 
11
+ # Manifesto Explainer with LLM Enhancement
12
+
13
+ This application analyzes political manifestos using advanced NLP and LLM techniques. It provides various insights including word frequency analysis, sentiment analysis, word clouds, and AI-generated summaries.
14
+
15
+ ## Features
16
+
17
+ - **AI-Generated Summary**: Uses Groq's LLaMA 3 model to generate concise summaries of manifestos
18
+ - **Enhanced Relevant Words Analysis**: Combines traditional frequency analysis with TF-IDF to find the most relevant topics
19
+ - **Context-Based Search**: Find specific terms within the manifesto with surrounding context
20
+ - **Visualizations**:
21
+ - Word Cloud: Visual representation of the most frequent words
22
+ - Sentiment Analysis: Analysis of positive, negative, and neutral sentiments
23
+ - Subjectivity Analysis: Analysis of subjective vs. objective content
24
+ - Frequency Distribution: Distribution of word frequencies
25
+ - Dispersion Plot: Visual representation of word occurrences throughout the text
26
+
27
+ ## Setup
28
+
29
+ 1. Install the required dependencies:
30
+ ```
31
+ pip install -r requirements.txt
32
+ ```
33
+
34
+ 2. Set up your Groq API key:
35
+ - Rename the `.env.example` file to `.env`
36
+ - Add your Groq API key to the `.env` file:
37
+ ```
38
+ GROQ_API_KEY=your_groq_api_key_here
39
+ ```
40
+ - You can get a Groq API key by signing up at [https://console.groq.com/](https://console.groq.com/)
41
+
42
+ 3. Run the application:
43
+ ```
44
+ python app.py
45
+ ```
46
+
47
+ 4. Open the application in your web browser at the URL displayed in the terminal (typically http://127.0.0.1:7860)
48
+
49
+ ## Usage
50
+
51
+ 1. Upload a PDF file containing a political manifesto
52
+ 2. Enter a search term to find specific mentions in the manifesto
53
+ 3. Click "Analyze Manifesto" to process the document
54
+ 4. View the results in the different tabs:
55
+ - **Summary**: AI-generated summary of the manifesto
56
+ - **Search Results**: Occurrences of your search term with context
57
+ - **Key Topics**: Most relevant topics identified using LLM-enhanced analysis
58
+ - **Visualizations**: Various visualizations of the manifesto content
59
+
60
+ ## Example Manifestos
61
+
62
+ The application comes with example manifestos in the `Example` folder:
63
+ - AAP Manifesto 2019
64
+ - BJP Manifesto 2019
65
+ - Congress Manifesto 2019
66
+
67
+ ## Note
68
+
69
+ If the Groq API key is not set up correctly, the summarization feature will be disabled, but all other features will continue to work.
70
+
71
+ ## Configuration
72
 
73
  `title`: _string_
74
  Display title for the Space