Spaces:
Running
Running
GitsSaikat
commited on
Commit
Β·
101d31b
1
Parent(s):
832926c
Create
Browse files
README.md
ADDED
@@ -0,0 +1,63 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1 |
+
# Deep Research Arxiv
|
2 |
+
|
3 |
+

|
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.
|