{"id":13582828,"url":"https://github.com/lifan0127/ai-research-assistant","last_synced_at":"2025-04-06T17:32:27.050Z","repository":{"id":152584820,"uuid":"620076077","full_name":"lifan0127/ai-research-assistant","owner":"lifan0127","description":"Aria is Your AI Research Assistant Powered by GPT Large Language Models","archived":false,"fork":false,"pushed_at":"2025-04-01T04:03:59.000Z","size":8161,"stargazers_count":1318,"open_issues_count":94,"forks_count":85,"subscribers_count":20,"default_branch":"main","last_synced_at":"2025-04-04T22:05:07.861Z","etag":null,"topics":["ai-assistant","gpt","large-language-models","research-paper","zotero"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lifan0127.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-03-28T01:30:13.000Z","updated_at":"2025-04-02T21:53:10.000Z","dependencies_parsed_at":"2023-07-20T05:22:33.067Z","dependency_job_id":"c978d40a-3937-4fe6-927b-d8526b6d9bea","html_url":"https://github.com/lifan0127/ai-research-assistant","commit_stats":null,"previous_names":[],"tags_count":51,"template":false,"template_full_name":"windingwind/zotero-plugin-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lifan0127%2Fai-research-assistant","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lifan0127%2Fai-research-assistant/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lifan0127%2Fai-research-assistant/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lifan0127%2Fai-research-assistant/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lifan0127","download_url":"https://codeload.github.com/lifan0127/ai-research-assistant/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247522663,"owners_count":20952596,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-assistant","gpt","large-language-models","research-paper","zotero"],"created_at":"2024-08-01T15:03:03.512Z","updated_at":"2025-04-06T17:32:22.040Z","avatar_url":"https://github.com/lifan0127.png","language":"JavaScript","funding_links":[],"categories":["JavaScript","Chatbots","Extension","Agent Categories","Extensions"],"sub_categories":["Note/Literature","\u003ca name=\"Unclassified\"\u003e\u003c/a\u003eUnclassified","AI Integrations"],"readme":"# A.R.I.A. (Aria) - Your AI Research Assistant\n\n[![License](https://img.shields.io/github/license/lifan0127/ai-research-assistant)](https://github.com/lifan0127/ai-research-assistant/blob/master/LICENSE)\n[![Using Zotero Plugin Template](https://img.shields.io/badge/Using-Zotero%20Plugin%20Template-blue?style=flat-square\u0026logo=github)](https://github.com/windingwind/zotero-plugin-template)\n[![Latest release](https://img.shields.io/github/v/release/lifan0127/ai-research-assistant)](https://github.com/lifan0127/ai-research-assistant/releases)\n![Downloads latest release](https://img.shields.io/github/downloads/lifan0127/ai-research-assistant/latest/total)\n\nAria is a Zotero plugin powered by Large Language Models (LLMs). A-R-I-A is the acronym of \"AI Research Assistant\" in reverse order.\n\nPlease make sure to choose the correct version based on your Zotero version:\n\n- Zotero 6: https://github.com/lifan0127/ai-research-assistant/releases/tag/0.8.0\n- Zotero 7: https://github.com/lifan0127/ai-research-assistant/releases/latest\n\n![Aria](assets/images/aria.png)\n\n## Quickstart\n\nThe easist way to get started with Aria is to try one of the interactive prompts in the prompt library.\n\n![Prompt Library](assets/videos/prompt-library.gif)\n\n## Features\n\n### Use Drag-and-Drop to Reference Your Zotero Items and Collections\n\n![Drag and Drop](assets/videos/drag-and-drop.gif)\n\n### Autocompletion for Creators (Authors), Tags, Items and More\n\n![Autocompletion](assets/videos/autocompletion.gif)\n\n### Visual Analysis (GPT-4 Vision)\n\n[_How to use Zotero area annotation to create a draggable area in PDF?_](https://youtu.be/lGeJCsNHBR4?si=sCnnaZCYI2CN8NJ3\u0026t=132)\n\n![Visual Analysis](assets/videos/gpt-4-vision.gif)\n\n### Save Chat as Notes and Annotations\n\n![Save Chat as Notes and Annotations](assets/videos/note-annotation.gif)\n\n\n## Zotero and GPT Requirements\n\n- Please note separate releases are available for Zotero 6 and 7:\n  - Zotero 6: https://github.com/lifan0127/ai-research-assistant/releases/tag/0.8.0\n  - Zotero 7: https://github.com/lifan0127/ai-research-assistant/releases/tag/v0.7.4\n- 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))\n- The visual analysis feature requires the preview access to the GPT-4 Vision model.\n\n## Installation\n\nFor a detailed walkthrough of the installation process, please check out: https://twitter.com/MushtaqBilalPhD/status/1735221900584865904 (credit: __Mushtaq Bilal, PhD__ - Syddansk Universitet)\n\n- Download the latest release (.xpi file) from GitHub: https://github.com/lifan0127/ai-research-assistant/releases/latest\n- In Zotero select \u003cem\u003eTools\u003c/em\u003e from the top menu bar, and then click on \u003cem\u003eAddons\u003c/em\u003e.\n- On the Add-ons Manager panel, click the gear icon at the top right corner and select \u003cem\u003eInstall Add-on From File\u003c/em\u003e\n- Select the .xpi file you just downloaded and click \u003cem\u003eOpen\u003c/em\u003e which will start the installation process.\n\n## Quickstart\n\nBy default, Aria can be activated by clicking the ![Aria launch button](addon/chrome/content/icons/favicon@16x16.png) button on Zoterol toolbar or through the \"Shift + R\" shortcut.\n\nBefore 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 \u003cb\u003erestart Zotero\u003c/b\u003e. ([screenshots](docs/configuration.md))\n\nAfter restart, you should see the activated Aria window (as shown above) and can start using it through conversations.\n\n\n## Preferences\n\nAria is configurable through Edit \u003e Preferences \u003e Aria. Please note that some changes require Zotero restart.\n\n- __Model Selection__: Choose between the base GPT-4 model and the new GPT-4 Turbo model (Preview).\n- __Zoom Level__: Adjust the zoom level to fit your screen resolution \n- __Keyboard shortcut__: Change the keyboard shortcut combination to better fit your workflow.\n\n![Aria](assets/images/preferences.png)\n\n## Update\n\n- Aria can perform automatic update when internet access is available. To check for available update, select \u003cem\u003eTools\u003c/em\u003e from the top menu bar, and then click on \u003cem\u003eAddons\u003c/em\u003e.\n- To manually update ARIA, click \u003cem\u003eMore\u003c/em\u003e under Aria and then click the gear icon at the top right corner. Select \u003cem\u003eCheck for Updates\u003c/em\u003e. ([screenshots](docs/update.md))\n\n## Limitations\n\nThe following are known limitations based on user feedback.\n\n- 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.\n- 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.\n\n## Troubleshooting\n\n  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!\n\n- \"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.\n\n- 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.\n\n## Development\n\nRefer 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.\n\n## Feedback\n\nYou can now submit feedback and share your chat session to help improve Aria. Let's make Aria better together!\n\n![Visual Analysis](assets/videos/feedback.gif)\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flifan0127%2Fai-research-assistant","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flifan0127%2Fai-research-assistant","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flifan0127%2Fai-research-assistant/lists"}