User guide¶
This guide covers the web application after an operator has installed JARVIS. It is written for individual researchers, families, and small teams sharing one self-hosted instance.
What it does¶
- Add papers from configured sources or by URL, DOI, title, or upload.
- Search and ask questions across analyzed papers with linked citations.
- Review citation and knowledge graphs and possible contradictions.
- Receive scheduled Pulse recommendations for research topics.
- Create and review spaced-repetition cards, notes, and projects.
- Optionally connect a Telegram bot.
- Use separate user and administrator accounts on a shared instance.
Who this manual is for¶
This guide is for researchers, family members, and small teams using an existing JARVIS instance. Operators should start with the installation guide, then return here for first sign-in and account setup.
Operators (people who install and maintain the system) should also read:
DEPLOYMENT.md— installation, the five access choices, Docker Compose configuration, and operations.SECURITY.md— hardening checklist, secret management, and known residual risks.
These documents are part of the repository and are available in the Get Started and Operate sections of this site.
Manual organisation¶
| Page | What it covers |
|---|---|
| First sign-in and setup | Create the first administrator, invite family, and add the first paper |
| Access from other devices | Choose localhost, private HTTPS, LAN diagnostics, Cloudflare, or your own domain |
| Passkeys | Add, remove, use, and recover from passkeys with or without email |
| Navigation | Sidebar, search, jobs, Pomodoro timer, and appearance controls |
| Home & My Day | Home dashboard, My Day page |
| Research Feed & Library | Inbox, Library, Discover (search), and Trash views of the feed |
| Paper Detail | Three-pane paper view: metadata, full text, RAG chat |
| Ask (Cross-paper RAG) | Ask questions that span your entire library |
| Pulse Deck | Daily recommendation deck, card rating, and schedule configuration |
| Projects | Organising papers into named projects |
| Knowledge Graph | Interactive concept-level knowledge graph |
| Citation Graph | Paper-level citation network explorer |
| Extraction Table | Structured data extracted from papers |
| Learning Cards | FSRS spaced-repetition review and card library |
| Analytics | Reading activity charts and corpus statistics |
| Settings | Sources, topics, automation, integrations, and account |
| What your hardware gets you | How detected hardware maps to model recommendations |
| Hardware support matrix | Supported GPU vendors and acceleration status |
| Telegram | Pairing your Telegram account and (admin) bot-token configuration |
| Backup and restore | Keep off-site restore points and recover the instance (admin) |
| Admin and multi-user operation | Invite users, manage access, health, backups, and logs (admin only) |