Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/eimenhmdt/autoresearcher
⚡ Automating scientific workflows with AI ⚡
https://github.com/eimenhmdt/autoresearcher
Last synced: about 1 month ago
JSON representation
⚡ Automating scientific workflows with AI ⚡
- Host: GitHub
- URL: https://github.com/eimenhmdt/autoresearcher
- Owner: eimenhmdt
- License: mit
- Created: 2023-04-08T23:00:05.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-08-15T17:05:09.000Z (4 months ago)
- Last Synced: 2024-09-16T18:56:41.412Z (3 months ago)
- Language: Python
- Homepage:
- Size: 647 KB
- Stars: 369
- Watchers: 15
- Forks: 37
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- StarryDivineSky - eimenhmdt/autoresearcher
README
# 🤖🧪 AutoResearcher
---
⚡ Automating scientific workflows with AI ⚡
[](https://discord.gg/PnQDR5h9)
---
## What is AutoResearcher?
AutoResearcher is an open-source Python package that leverages AI models and external knowledge sources to automate scientific workflows. Designed to help researchers and scientists accelerate their research process and increase efficiency, AutoResearcher is a powerful tool for the modern scientific community.
Please note that the project is currently in its early prototype stage and under active development. Its present functionality is limited to conducting literature reviews, but the ultimate goal is to create a tool capable of driving scientific discovery on autopilot.
If this vision excites you, we invite you to contribute to the project. Start by joining our [Discord server](https://discord.gg/jUMfu4D4je) and discussing your ideas with our community.
## Documentation
Documentation for the package is available [here](https://eimenhmdt.github.io/autoresearcher/).
## Installation
Install the package using pip:
```bash
pip install autoresearcher
```
## Setting Environment Variables
Before using the package, you need to set the following environment variables:
- `OPENAI_API_KEY`: Your OpenAI API key for accessing the GPT-based AI models.
- `EMAIL`: An email address of your choice (used to identify your API requests for getting citations).
You can set the environment variables in your operating system or in your Python script using the `os` module:
```python
import os
os.environ["OPENAI_API_KEY"] = ""
os.environ["EMAIL"] = ""
```
Replace and with your actual API key and email address.
## Usage
1. Import the literature_review function from the package:
```python
from autoresearcher import literature_review
```
2. Set your research question as a string:
```python
research_question = "What is the best way to train a neural network?"
```
3. Create a literature_review instance with your research question and execute it:
```python
researcher = literature_review(research_question)
```
You can also pass an output file name as a .txt file:
```python
researcher = literature_review(research_question, output_file="my_literature_review.txt")
```
This will generate a literature review based on the research question.
Also, you can run it in one command:
```python
python run_autorsearcher.py --research_question "" --output_file ""
```
4. To use GPT-4o instead of the default GPT-4o-mini, set the `use_gpt4` parameter to `True`:
```python
researcher = literature_review(research_question, use_gpt4=True)
```
Note that using GPT-4o may result in higher costs and potentially longer processing times.
## Contributing
We welcome contributions! Feel free to submit issues or create pull requests. Together, let's revolutionize science! 🚀
## License
This project is licensed under the MIT License. See the LICENSE file for details.
Made with ☕ by [@eimenhamedat](https://twitter.com/eimenhmdt)