Skip to content

ArionDas/ArionXiv

Repository files navigation

image

Note

Let's face it, nobody has the bandwidth, nor the patience to go through entire papers every single day.
But that doesn't mean you will have to miss out on all these interesting launches everyday!
Use ArionXiv, automate it! Its absolutely FREE for all!


Installation

pip install arionxiv

Important

If the command is not found after installation, add Python scripts to PATH:

Windows (PowerShell):

python -c "import sysconfig; p=sysconfig.get_path('scripts'); import os; os.system(f'setx PATH \"%PATH%;{p}\"')"

macOS / Linux:

echo "export PATH=\"\$PATH:$(python3 -c 'import sysconfig; print(sysconfig.get_path(\"scripts\"))')\"" >> ~/.bashrc && source ~/.bashrc

Getting Started

Welcome to ArionXiv

Important

The first command you should always run is this, it'll display the welcome screen and guide you through the initial setup.:

arionxiv welcome

Create an Account

Important

First-time users must create an account to use ArionXiv:

arionxiv register   # Create a new account (required for first-time users)
arionxiv login      # Login to existing account

Once registered, you can access all features including paper search, AI analysis, chat, and personalized recommendations.

That's it. No API keys or configuration required.


Features

1. Daily Dose of AI

Configure your keywords, time, and number of papers (max 10) - and you'll have analysis of all these papers ready for you the next time you come in.
(I use it to run analysis overnight, so I can quickly skim through the papers in the morning.)

arionxiv daily
arionxiv daily --run
arionxiv daily --dose

image

Configure schedule and preferences:

arionxiv settings daily

image


2. Paper Analysis

Get exhaustive analysis on the paper.

arionxiv search "transformer architecture"
# Select a paper → Choose "Analyze"

image


3. Chat with Papers

Interactive RAG-based Q&A with any paper. Supports session persistence and history.

arionxiv chat

Features:

  • Context-aware responses using paper content
  • Chat history maintained indefinitely
  • Chat session persisted for 24 hours for reuse
  • Chat history also persisted for reuse

image


4. Personal Library

Save papers and manage your research collection.

arionxiv library
arionxiv settings papers

image


6. Trending Papers

Discover trending research topics and papers.

arionxiv trending

Note

Feature coming soon...!


7. Themes

Customizable terminal interface with multiple color themes.

arionxiv settings theme

image


Command Reference

Command Description
arionxiv welcome Welcome screen (run this first!)
arionxiv Main menu
arionxiv search <query> Search for papers (with analyze option)
arionxiv chat [paper_id] Interactive RAG chat with papers
arionxiv daily Daily personalized recommendations
arionxiv trending Discover trending topics
arionxiv library View saved papers
arionxiv settings Configuration menu
arionxiv register Create new account
arionxiv login Login to existing account
arionxiv session Check authentication status
arionxiv --help Show all commands

Configuration

Settings Commands

arionxiv settings show         # View all settings
arionxiv settings theme        # Change color theme
arionxiv settings api          # Configure optional API keys (OpenRouter, Gemini, Groq)
arionxiv settings preferences  # Research preferences
arionxiv settings daily        # Daily dose schedule
arionxiv settings papers       # Manage saved papers

Self-Hosting

Note

Note: Regular users do NOT need to self-host. ArionXiv automatically connects to our hosted backend service. This section is only for people who want to run models through their own APIs.

Using command "arionxiv settings api":

Variable Description
OPENROUTER_API_KEY OpenRouter API key for LLM
GEMINI_API_KEY Google Gemini embeddings (optional)
GROQ_API_KEY Fallback LLM provider (optional)

Important

Don't get freaked out by the python libraries getting installed! It's completely normal.

Warning

The application is built in a way that it will work perfectly given all the packages have been installed correctly. In case you observe any inconsistencies/warnings, it could either be some packages didn't get installed correctly, or there might have been an outdated version of the same existing in your system.


Links


License

MIT License

About

Don't read academic papers manually anymore. Analyze, save, and chat with papers based on your own preferences.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages