Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

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

Awesome Lists containing this project

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)