arionxiv 1.0.30__tar.gz

arionxiv-1.0.30/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Arion Das
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

arionxiv-1.0.30/MANIFEST.in

@@ -0,0 +1,17 @@
+include README.md
+include LICENSE
+include requirements.txt
+include library.json
+recursive-include arionxiv *.py
+recursive-include arionxiv *.json
+prune downloads
+prune logs
+prune venv
+prune tests
+prune scripts
+prune .git
+global-exclude __pycache__
+global-exclude *.py[cod]
+global-exclude *.so
+global-exclude .DS_Store
+global-exclude *.egg-info

arionxiv-1.0.30/PKG-INFO

@@ -0,0 +1,337 @@
+Metadata-Version: 2.4
+Name: arionxiv
+Version: 1.0.30
+Summary: AI-Powered Research Paper Analysis and Management System
+Home-page: https://github.com/ArionDas/ArionXiv
+Author: Arion Das
+Author-email: Arion Das <ariondasad@gmail.com>
+Maintainer-email: Arion Das <ariondasad@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/ArionDas/ArionXiv
+Project-URL: Documentation, https://github.com/ArionDas/ArionXiv#readme
+Project-URL: Repository, https://github.com/ArionDas/ArionXiv
+Project-URL: Bug Tracker, https://github.com/ArionDas/ArionXiv/issues
+Keywords: arxiv,research,papers,ai,machine-learning,nlp,analysis,academic,scientific,publication,pdf,text-extraction,mongodb,cli,api
+Platform: any
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Education
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Text Processing :: Linguistic
+Classifier: Topic :: Database :: Front-Ends
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Classifier: Environment :: Console
+Classifier: Environment :: Web Environment
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rich>=13.0.0
+Requires-Dist: click>=8.0.0
+Requires-Dist: colorama>=0.4.6
+Requires-Dist: requests>=2.31.0
+Requires-Dist: aiohttp>=3.8.0
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: PyPDF2>=3.0.0
+Requires-Dist: pymupdf>=1.23.0
+Requires-Dist: Pillow>=9.0.0
+Requires-Dist: arxiv>=2.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: PyJWT>=2.8.0
+Requires-Dist: structlog>=23.0.0
+Requires-Dist: numpy<2.0.0,>=1.24.0
+Requires-Dist: google-genai>=1.0.0
+Requires-Dist: groq>=0.4.0
+Requires-Dist: pymongo<5.0,>=4.9
+Requires-Dist: motor>=3.0.0
+Provides-Extra: advanced-pdf
+Requires-Dist: pdfplumber>=0.10.0; extra == "advanced-pdf"
+Requires-Dist: pytesseract>=0.3.10; extra == "advanced-pdf"
+Requires-Dist: tabula-py>=2.9.0; extra == "advanced-pdf"
+Requires-Dist: Pillow>=9.0.0; extra == "advanced-pdf"
+Requires-Dist: opencv-python>=4.8.0; extra == "advanced-pdf"
+Provides-Extra: ml
+Requires-Dist: sentence-transformers>=3.0.0; extra == "ml"
+Requires-Dist: torch>=2.0.0; extra == "ml"
+Requires-Dist: transformers>=4.20.0; extra == "ml"
+Provides-Extra: enhanced-ui
+Requires-Dist: inquirer>=3.1.0; extra == "enhanced-ui"
+Requires-Dist: tabulate>=0.9.0; extra == "enhanced-ui"
+Requires-Dist: prompt-toolkit>=3.0.0; extra == "enhanced-ui"
+Requires-Dist: alive-progress>=3.1.0; extra == "enhanced-ui"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: flake8>=6.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: pre-commit>=3.0.0; extra == "dev"
+Provides-Extra: all
+Requires-Dist: pdfplumber>=0.10.0; extra == "all"
+Requires-Dist: pytesseract>=0.3.10; extra == "all"
+Requires-Dist: tabula-py>=2.9.0; extra == "all"
+Requires-Dist: Pillow>=9.0.0; extra == "all"
+Requires-Dist: opencv-python>=4.8.0; extra == "all"
+Requires-Dist: sentence-transformers>=3.0.0; extra == "all"
+Requires-Dist: torch>=2.0.0; extra == "all"
+Requires-Dist: transformers>=4.20.0; extra == "all"
+Requires-Dist: inquirer>=3.1.0; extra == "all"
+Requires-Dist: tabulate>=0.9.0; extra == "all"
+Requires-Dist: prompt-toolkit>=3.0.0; extra == "all"
+Requires-Dist: alive-progress>=3.1.0; extra == "all"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: platform
+Dynamic: requires-python
+
+# ArionXiv
+
+A command-line interface for discovering, analyzing, and interacting with research papers from arXiv.
+
+---
+
+## Installation
+
+```bash
+pip install arionxiv
+```
+
+If the command is not found after installation, add Python scripts to PATH:
+
+**Windows (PowerShell):**
+```powershell
+python -c "import sysconfig; p=sysconfig.get_path('scripts'); import os; os.system(f'setx PATH \"%PATH%;{p}\"')"
+```
+
+**macOS / Linux:**
+```bash
+echo "export PATH=\"\$PATH:$(python3 -c 'import sysconfig; print(sysconfig.get_path(\"scripts\"))')\"" >> ~/.bashrc && source ~/.bashrc
+```
+
+---
+
+## Getting Started
+
+### First Run
+
+```bash
+arionxiv
+```
+
+On first run, register or login to your account:
+
+```bash
+arionxiv register   # Create a new account
+arionxiv login      # Login to existing account
+```
+
+That's it. No API keys or configuration required.
+
+---
+
+## Features
+
+### 1. Paper Search
+
+Search arXiv with relevance scoring and filtering.
+
+```bash
+arionxiv search "transformer architecture"
+arionxiv search "reinforcement learning" --max-results 20
+```
+
+<!-- Screenshot: search results -->
+
+---
+
+### 2. Paper Analysis
+
+AI-powered deep analysis of research papers.
+
+```bash
+arionxiv analyze 2301.00001
+arionxiv analyze 2301.00001 --detailed
+```
+
+<!-- Screenshot: analysis output -->
+
+---
+
+### 3. Chat with Papers
+
+Interactive RAG-based Q&A with any paper. Supports session persistence and history.
+
+```bash
+arionxiv chat
+arionxiv chat 2301.00001
+```
+
+**Features:**
+- Context-aware responses using paper content
+- Session persistence across restarts
+- Chat history (last 8 Q&A pairs) on resume
+- Cached embeddings for instant session loading
+
+<!-- Screenshot: chat interface -->
+
+---
+
+### 4. Personal Library
+
+Save papers and manage your research collection.
+
+```bash
+arionxiv library
+arionxiv settings papers
+```
+
+<!-- Screenshot: library view -->
+
+---
+
+### 5. Daily Dose
+
+Personalized daily paper recommendations based on your research interests.
+
+```bash
+arionxiv daily
+arionxiv daily --run
+arionxiv daily --view
+```
+
+Configure schedule and preferences:
+
+```bash
+arionxiv settings daily
+```
+
+<!-- Screenshot: daily dose -->
+
+---
+
+### 6. Trending Papers
+
+Discover trending research topics and papers.
+
+```bash
+arionxiv trending
+```
+
+<!-- Screenshot: trending view -->
+
+---
+
+### 7. Themes
+
+Customizable terminal interface with multiple color themes.
+
+```bash
+arionxiv settings theme
+```
+
+Available themes: cyan, green, magenta, yellow, red, blue, white
+
+<!-- Screenshot: theme options -->
+
+---
+
+## Command Reference
+
+| Command | Description |
+|---------|-------------|
+| `arionxiv` | Main menu |
+| `arionxiv search <query>` | Search for papers |
+| `arionxiv fetch <paper_id>` | Download paper PDF |
+| `arionxiv analyze <paper_id>` | AI analysis |
+| `arionxiv chat [paper_id]` | Chat with papers |
+| `arionxiv daily` | Daily recommendations |
+| `arionxiv trending` | Trending topics |
+| `arionxiv library` | Saved papers |
+| `arionxiv settings` | Configuration |
+| `arionxiv login` | Authenticate |
+| `arionxiv register` | Create account |
+| `arionxiv session` | Check auth status |
+| `arionxiv --help` | Show all commands |
+
+---
+
+## Configuration
+
+### Settings Commands
+
+```bash
+arionxiv settings show      # View all settings
+arionxiv settings theme     # Change color theme
+arionxiv settings api       # Configure optional API keys (Gemini, Groq, HuggingFace)
+arionxiv settings prefs     # Research preferences
+arionxiv settings daily     # Daily dose schedule
+arionxiv settings papers    # Manage saved papers
+```
+
+### Self-Hosting (Optional)
+
+If you want to run your own backend instead of using the hosted service:
+
+| Variable | Description |
+|----------|-------------|
+| `MONGODB_URI` | MongoDB connection string |
+| `OPENROUTER_API_KEY` | OpenRouter API key |
+| `JWT_SECRET_KEY` | Authentication secret |
+| `GEMINI_API_KEY` | Google Gemini embeddings (optional) |
+| `GROQ_API_KEY` | Fallback LLM provider (optional) |
+
+---
+
+## Optional Dependencies
+
+```bash
+pip install arionxiv[advanced-pdf]  # OCR and table extraction
+pip install arionxiv[ml]            # Local embeddings
+pip install arionxiv[all]           # All extras
+```
+
+---
+
+## Daily Dose Automation
+
+### GitHub Actions
+
+1. Fork the repository
+2. Add secrets in Settings > Secrets:
+   - `MONGODB_URI`
+   - `OPENROUTER_API_KEY`
+   - `JWT_SECRET_KEY`
+3. The workflow runs hourly and processes users based on their scheduled time
+
+---
+
+## Alternative Invocation
+
+If the `arionxiv` command is not available:
+
+```bash
+python -m arionxiv <command>
+```
+
+---
+
+## Links
+
+- PyPI: https://pypi.org/project/arionxiv/
+- GitHub: https://github.com/ArionDas/ArionXiv
+- Issues: https://github.com/ArionDas/ArionXiv/issues
+
+---
+
+## License
+
+MIT License

arionxiv-1.0.30/README.md

@@ -0,0 +1,242 @@
+# ArionXiv
+
+A command-line interface for discovering, analyzing, and interacting with research papers from arXiv.
+
+---
+
+## Installation
+
+```bash
+pip install arionxiv
+```
+
+If the command is not found after installation, add Python scripts to PATH:
+
+**Windows (PowerShell):**
+```powershell
+python -c "import sysconfig; p=sysconfig.get_path('scripts'); import os; os.system(f'setx PATH \"%PATH%;{p}\"')"
+```
+
+**macOS / Linux:**
+```bash
+echo "export PATH=\"\$PATH:$(python3 -c 'import sysconfig; print(sysconfig.get_path(\"scripts\"))')\"" >> ~/.bashrc && source ~/.bashrc
+```
+
+---
+
+## Getting Started
+
+### First Run
+
+```bash
+arionxiv
+```
+
+On first run, register or login to your account:
+
+```bash
+arionxiv register   # Create a new account
+arionxiv login      # Login to existing account
+```
+
+That's it. No API keys or configuration required.
+
+---
+
+## Features
+
+### 1. Paper Search
+
+Search arXiv with relevance scoring and filtering.
+
+```bash
+arionxiv search "transformer architecture"
+arionxiv search "reinforcement learning" --max-results 20
+```
+
+<!-- Screenshot: search results -->
+
+---
+
+### 2. Paper Analysis
+
+AI-powered deep analysis of research papers.
+
+```bash
+arionxiv analyze 2301.00001
+arionxiv analyze 2301.00001 --detailed
+```
+
+<!-- Screenshot: analysis output -->
+
+---
+
+### 3. Chat with Papers
+
+Interactive RAG-based Q&A with any paper. Supports session persistence and history.
+
+```bash
+arionxiv chat
+arionxiv chat 2301.00001
+```
+
+**Features:**
+- Context-aware responses using paper content
+- Session persistence across restarts
+- Chat history (last 8 Q&A pairs) on resume
+- Cached embeddings for instant session loading
+
+<!-- Screenshot: chat interface -->
+
+---
+
+### 4. Personal Library
+
+Save papers and manage your research collection.
+
+```bash
+arionxiv library
+arionxiv settings papers
+```
+
+<!-- Screenshot: library view -->
+
+---
+
+### 5. Daily Dose
+
+Personalized daily paper recommendations based on your research interests.
+
+```bash
+arionxiv daily
+arionxiv daily --run
+arionxiv daily --view
+```
+
+Configure schedule and preferences:
+
+```bash
+arionxiv settings daily
+```
+
+<!-- Screenshot: daily dose -->
+
+---
+
+### 6. Trending Papers
+
+Discover trending research topics and papers.
+
+```bash
+arionxiv trending
+```
+
+<!-- Screenshot: trending view -->
+
+---
+
+### 7. Themes
+
+Customizable terminal interface with multiple color themes.
+
+```bash
+arionxiv settings theme
+```
+
+Available themes: cyan, green, magenta, yellow, red, blue, white
+
+<!-- Screenshot: theme options -->
+
+---
+
+## Command Reference
+
+| Command | Description |
+|---------|-------------|
+| `arionxiv` | Main menu |
+| `arionxiv search <query>` | Search for papers |
+| `arionxiv fetch <paper_id>` | Download paper PDF |
+| `arionxiv analyze <paper_id>` | AI analysis |
+| `arionxiv chat [paper_id]` | Chat with papers |
+| `arionxiv daily` | Daily recommendations |
+| `arionxiv trending` | Trending topics |
+| `arionxiv library` | Saved papers |
+| `arionxiv settings` | Configuration |
+| `arionxiv login` | Authenticate |
+| `arionxiv register` | Create account |
+| `arionxiv session` | Check auth status |
+| `arionxiv --help` | Show all commands |
+
+---
+
+## Configuration
+
+### Settings Commands
+
+```bash
+arionxiv settings show      # View all settings
+arionxiv settings theme     # Change color theme
+arionxiv settings api       # Configure optional API keys (Gemini, Groq, HuggingFace)
+arionxiv settings prefs     # Research preferences
+arionxiv settings daily     # Daily dose schedule
+arionxiv settings papers    # Manage saved papers
+```
+
+### Self-Hosting (Optional)
+
+If you want to run your own backend instead of using the hosted service:
+
+| Variable | Description |
+|----------|-------------|
+| `MONGODB_URI` | MongoDB connection string |
+| `OPENROUTER_API_KEY` | OpenRouter API key |
+| `JWT_SECRET_KEY` | Authentication secret |
+| `GEMINI_API_KEY` | Google Gemini embeddings (optional) |
+| `GROQ_API_KEY` | Fallback LLM provider (optional) |
+
+---
+
+## Optional Dependencies
+
+```bash
+pip install arionxiv[advanced-pdf]  # OCR and table extraction
+pip install arionxiv[ml]            # Local embeddings
+pip install arionxiv[all]           # All extras
+```
+
+---
+
+## Daily Dose Automation
+
+### GitHub Actions
+
+1. Fork the repository
+2. Add secrets in Settings > Secrets:
+   - `MONGODB_URI`
+   - `OPENROUTER_API_KEY`
+   - `JWT_SECRET_KEY`
+3. The workflow runs hourly and processes users based on their scheduled time
+
+---
+
+## Alternative Invocation
+
+If the `arionxiv` command is not available:
+
+```bash
+python -m arionxiv <command>
+```
+
+---
+
+## Links
+
+- PyPI: https://pypi.org/project/arionxiv/
+- GitHub: https://github.com/ArionDas/ArionXiv
+- Issues: https://github.com/ArionDas/ArionXiv/issues
+
+---
+
+## License
+
+MIT License

arionxiv-1.0.30/arionxiv/__init__.py

@@ -0,0 +1,40 @@
+"""
+ArionXiv - AI-Powered Research Paper Analysis and Management
+
+A comprehensive tool for discovering, analyzing, and managing research papers
+from arXiv with AI-powered insights and organizational features.
+"""
+
+__version__ = "1.0.29"
+__author__ = "Arion Das"
+__email__ = "ariondasad@gmail.com"
+__description__ = "AI-Powered Research Paper Analysis and Management"
+
+# Lazy imports to avoid requiring fastapi for CLI/GitHub Actions usage
+# Services are imported on-demand when accessed
+def __getattr__(name):
+    """Lazy import of services to avoid loading fastapi for CLI usage."""
+    if name == "config":
+        from .services.unified_config_service import config
+        return config
+    elif name == "database_service":
+        from .services.unified_database_service import database_service
+        return database_service
+    elif name == "paper_service":
+        from .services.unified_paper_service import paper_service
+        return paper_service
+    elif name == "analysis_service":
+        from .services.unified_analysis_service import analysis_service
+        return analysis_service
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+__all__ = [
+    "__version__",
+    "__author__", 
+    "__email__",
+    "__description__",
+    "config",
+    "database_service",
+    "paper_service", 
+    "analysis_service"
+]

arionxiv-1.0.30/arionxiv/__main__.py

@@ -0,0 +1,10 @@
+#!/usr/bin/env python3
+"""
+ArionXiv package main entry point
+"""
+
+import sys
+from .cli.main import cli
+
+if __name__ == "__main__":
+    cli()