Installation

Two ways to get linXiv: download a prebuilt desktop app, or build it from source.

Download the app

The fastest way to start — grab the installer for your platform. Your system is detected automatically; see the downloads page for every platform and format.

Download

Build from source

The desktop app is a Tauri + React shell around the Python backend. These steps get a development build running locally.

1. Clone the repository

git clone https://github.com/linxiv-dev/linXiv.git && cd linXiv

2. Install dependencies

npm install && uv sync

3. Launch the desktop app

npm run tauri:dev

Notes

Requires Node.js, Rust (for Tauri), Python 3.10+, and uv.
Optional: add GENAI_API_KEY_TAG_GEN (or Gemini/OpenAI keys in Settings) for AI features.
Production build: npm run build:all
CLI/API only (no desktop UI): uv sync --no-group gui && python -m api