GitsSaikat commited on
Commit
101d31b
Β·
1 Parent(s): 832926c
Files changed (1) hide show
  1. README.md +63 -0
README.md ADDED
@@ -0,0 +1,63 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Deep Research Arxiv
2
+
3
+ ![Logo](logo_a.png)
4
+
5
+ Deep Research Arxiv is a Streamlit-powered application designed to assist researchers in conducting comprehensive literature reviews using the Arxiv repository. This tool searches, analyzes, and synthesizes relevant papers into a cohesive literature review formatted in the Nature journal style.
6
+
7
+ ## Features
8
+ - **Literature Search**: Query the Arxiv API to retrieve relevant research papers.
9
+ - **Paper Analysis**: Analyze selected papers and extract key information.
10
+ - **Automated Review Generation**: Leverage OpenRouter to generate detailed literature reviews.
11
+ - **Citation Formatting**: Provides formatted references and BibTeX entries for seamless citation integration.
12
+ - **Customizable API Configuration**: Easily configure your OpenRouter API key directly within the app.
13
+
14
+ ## Installation
15
+
16
+ 1. **Clone the Repository**
17
+ ```
18
+ git clone https://github.com/your-repo/deep-research-arxiv.git
19
+ cd deep-research-arxiv
20
+ ```
21
+
22
+ 2. **Set Up a Virtual Environment (Optional but Recommended)**
23
+ ```
24
+ python -m venv venv
25
+ source venv/bin/activate # On Windows use `venv\Scripts\activate`
26
+ ```
27
+
28
+ 3. **Install Dependencies**
29
+ ```
30
+ pip install -r requirements.txt
31
+ ```
32
+
33
+ 4. **Place the Logo and Banner Images**
34
+ - Ensure `logo_a.png` and `banner.png` are located in the root directory.
35
+
36
+ ## Usage
37
+
38
+ 1. **Configure API Key**
39
+ - Launch the application with:
40
+ ```
41
+ streamlit run app.py
42
+ ```
43
+ - Use the sidebar in the app to enter and save your OpenRouter API key.
44
+
45
+ 2. **Start Your Research**
46
+ - Enter your research query and choose the number of papers to analyze.
47
+ - Click the "πŸš€ Start Research" button to generate a comprehensive literature review.
48
+ - Download the generated review along with well-formatted citations.
49
+
50
+ ## File Structure
51
+ ```
52
+ β”œβ”€β”€ app.py # Main Streamlit application
53
+ β”œβ”€β”€ research
54
+ β”‚ └── arxiv_research.py # Module handling Arxiv API and review generation
55
+ β”œβ”€β”€ logo_a.png # Repository logo
56
+ β”œβ”€β”€ banner.png # Banner image for the app
57
+ └── README.md # This file
58
+ ```
59
+
60
+
61
+ ## License
62
+
63
+ This project is licensed under the MIT License. For more details, please refer to the [LICENSE](LICENSE) file.