Skip to main content

Automating scientic workflows with AI

Project description

🤖🧪 AutoResearcher


⚡ Automating scientific workflows with AI ⚡

GitHub Repo stars Discord


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 and discussing your ideas with our community.

Documentation

Documentation for the package is available here.

Installation

Install the package using pip:

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:

import os

os.environ["OPENAI_API_KEY"] = "<your_openai_api_key>"
os.environ["EMAIL"] = "<your_email>"

Replace <your_openai_api_key> and <your_email> with your actual API key and email address.

Usage

  1. Import the literature_review function from the package:
from autoresearcher import literature_review
  1. Set your research question as a string:
research_question = "What is the best way to train a neural network?"
  1. Create a literature_review instance with your research question and execute it:
researcher = literature_review(research_question)

You can also pass an output file name as a .txt file:

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 run_autorsearcher.py --research_question "<your_research_question>" --output_file "<your_output_file>"
  1. To use GPT-4o instead of the default GPT-4o-mini, set the use_gpt4 parameter to True:
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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

autoresearcher-0.0.8.tar.gz (12.4 kB view details)

Uploaded Source

Built Distribution

autoresearcher-0.0.8-py3-none-any.whl (15.7 kB view details)

Uploaded Python 3

File details

Details for the file autoresearcher-0.0.8.tar.gz.

File metadata

  • Download URL: autoresearcher-0.0.8.tar.gz
  • Upload date:
  • Size: 12.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.4

File hashes

Hashes for autoresearcher-0.0.8.tar.gz
Algorithm Hash digest
SHA256 2de809acf6a44bb34b3df8ca6b4cffc0db81fb2ab72cd4cda8db1681049c1a5f
MD5 46e146ebdae6c0b9ca7a26b03d6a201b
BLAKE2b-256 47b9b0fe689a6b4e2613139d9662a22d05d402518be01d524324fb8fb737bff1

See more details on using hashes here.

File details

Details for the file autoresearcher-0.0.8-py3-none-any.whl.

File metadata

File hashes

Hashes for autoresearcher-0.0.8-py3-none-any.whl
Algorithm Hash digest
SHA256 1b6ceae65a24aec974ebd244153b4192f66903cfb0bff6f9b1fa1fcebcf3f8ac
MD5 9b49eee540bc3dd1913d7cfd34993067
BLAKE2b-256 a7bcc82d2fe68110944e1f74291e81876de9002a13960d05bdcf5093ea97848c

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page