Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lifan0127/ai-research-assistant
Aria is Your AI Research Assistant Powered by GPT Large Language Models
https://github.com/lifan0127/ai-research-assistant
ai-assistant gpt large-language-models research-paper zotero
Last synced: 3 months ago
JSON representation
Aria is Your AI Research Assistant Powered by GPT Large Language Models
- Host: GitHub
- URL: https://github.com/lifan0127/ai-research-assistant
- Owner: lifan0127
- License: agpl-3.0
- Created: 2023-03-28T01:30:13.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-04-15T12:30:44.000Z (10 months ago)
- Last Synced: 2024-05-18T03:47:34.747Z (8 months ago)
- Topics: ai-assistant, gpt, large-language-models, research-paper, zotero
- Language: JavaScript
- Homepage:
- Size: 6.81 MB
- Stars: 743
- Watchers: 14
- Forks: 33
- Open Issues: 44
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ChatGPT-repositories - ai-research-assistant - Aria is Your AI Research Assistant Powered by GPT Large Language Models (Chatbots)
- awesome-ai-api-projects - ai-research-assistant - and-Drop referencing, autocompletion, visual analysis, and the ability to save chats as notes and annotations. | open | Zotero | [OpenAI](https://platform.openai.com/playground) | ![GitHub last commit](https://img.shields.io/github/last-commit/lifan0127/ai-research-assistant?label=%20) | (Extension / Note/Literature)
README
# A.R.I.A. (Aria) - Your AI Research Assistant
[![License](https://img.shields.io/github/license/lifan0127/ai-research-assistant)](https://github.com/lifan0127/ai-research-assistant/blob/master/LICENSE)
[![Using Zotero Plugin Template](https://img.shields.io/badge/Using-Zotero%20Plugin%20Template-blue?style=flat-square&logo=github)](https://github.com/windingwind/zotero-plugin-template)
[![Latest release](https://img.shields.io/github/v/release/lifan0127/ai-research-assistant)](https://github.com/lifan0127/ai-research-assistant/releases)
![Downloads latest release](https://img.shields.io/github/downloads/lifan0127/ai-research-assistant/latest/total)Aria is a Zotero plugin powered by Large Language Models (LLMs). A-R-I-A is the acronym of "AI Research Assistant" in reverse order.
Please make sure to choose the correct version based on your Zotero version:
- Zotero 6: https://github.com/lifan0127/ai-research-assistant/releases/tag/0.8.0
- Zotero 7: https://github.com/lifan0127/ai-research-assistant/releases/latest![Aria](assets/images/aria.png)
## Quickstart
The easist way to get started with Aria is to try one of the interactive prompts in the prompt library.
![Prompt Library](assets/videos/prompt-library.gif)
## Features
### Use Drag-and-Drop to Reference Your Zotero Items and Collections
![Drag and Drop](assets/videos/drag-and-drop.gif)
### Autocompletion for Creators (Authors), Tags, Items and More
![Autocompletion](assets/videos/autocompletion.gif)
### Visual Analysis (GPT-4 Vision)
[_How to use Zotero area annotation to create a draggable area in PDF?_](https://youtu.be/lGeJCsNHBR4?si=sCnnaZCYI2CN8NJ3&t=132)
![Visual Analysis](assets/videos/gpt-4-vision.gif)
### Save Chat as Notes and Annotations
![Save Chat as Notes and Annotations](assets/videos/note-annotation.gif)
## Zotero and GPT Requirements
- Please note separate releases are available for Zotero 6 and 7:
- Zotero 6: https://github.com/lifan0127/ai-research-assistant/releases/tag/0.8.0
- Zotero 7: https://github.com/lifan0127/ai-research-assistant/releases/tag/v0.7.4
- Aria requires the OpenAI GPT-4 model family. ([how can I access GPT-4?](https://help.openai.com/en/articles/7102672-how-can-i-access-gpt-4))
- The visual analysis feature requires the preview access to the GPT-4 Vision model.## Installation
For a detailed walkthrough of the installation process, please check out: https://twitter.com/MushtaqBilalPhD/status/1735221900584865904 (credit: __Mushtaq Bilal, PhD__ - Syddansk Universitet)
- Download the latest release (.xpi file) from GitHub: https://github.com/lifan0127/ai-research-assistant/releases/latest
- In Zotero select Tools from the top menu bar, and then click on Addons.
- On the Add-ons Manager panel, click the gear icon at the top right corner and select Install Add-on From File
- Select the .xpi file you just downloaded and click Open which will start the installation process.## Quickstart
By default, Aria can be activated by clicking the ![Aria launch button](addon/chrome/content/icons/[email protected]) button on Zoterol toolbar or through the "Shift + R" shortcut.
Before using Aria, you need to provide an [OpenAI API Key](https://platform.openai.com/account/api-keys). Follow the in-app instruction to add a key and restart Zotero. ([screenshots](docs/configuration.md))
After restart, you should see the activated Aria window (as shown above) and can start using it through conversations.
## Preferences
Aria is configurable through Edit > Preferences > Aria. Please note that some changes require Zotero restart.
- __Model Selection__: Choose between the base GPT-4 model and the new GPT-4 Turbo model (Preview).
- __Zoom Level__: Adjust the zoom level to fit your screen resolution
- __Keyboard shortcut__: Change the keyboard shortcut combination to better fit your workflow.![Aria](assets/images/preferences.png)
## Update
- Aria can perform automatic update when internet access is available. To check for available update, select Tools from the top menu bar, and then click on Addons.
- To manually update ARIA, click More under Aria and then click the gear icon at the top right corner. Select Check for Updates. ([screenshots](docs/update.md))## Limitations
The following are known limitations based on user feedback.
- Currently Aria can query your Zotero library through the Zotero search API. The ability to query the Zotero SQLite database for document count and other metrics will be delivered in a future release.
- Aria has limited awareness of your Zotero application state (selected item, current tab, highlighted text). However, you can use the drag-n-drop and the autocompeltion features to provide such context within your message.## Troubleshooting
Interaction with Zotero, in an open conversational manner and through a probabilistic model, can lead to many different, often unexpected outcomes. If you experience any error, please create an GitHub issue with a screenshot of the error message from your Aria chat window. Thank you!
- "Agent stopped due to max iterations": For certain questions, the bot will make multiple API calls iteratively for response synthesis. Sometimes, it may fail to produce an answer before reaching the max iterations.
- Aria tab not in Preferences panel: You may choose the __Advanced__ tab in Preferences and open the __Configuration Editor__ Under Advanced Configuration. From there, please search for "aria" and then double-click on the "extensions.zotero.aria.OPENAI_API_KEY" entry to add your OpenAI API Key.
## Development
Refer to the [Zotero Plugin Development](https://www.zotero.org/support/dev/client_coding/plugin_development) guide to find instructions on how to setup the plugin in your local environment.
## Feedback
You can now submit feedback and share your chat session to help improve Aria. Let's make Aria better together!
![Visual Analysis](assets/videos/feedback.gif)