---
title: Research Navigator
emoji: 🐝
colorFrom: indigo
colorTo: purple
sdk: docker
app_port: 7860
pinned: false
license: mit
short_description: Journal finder, OA rights checker, data repository guide
---

# 🐝 Research Navigator

**Publishing & Repository Assistant for Khalifa University Researchers**

> *Find the right journal. Check your rights. Deposit to the right repository.*

Research Navigator is an AI-powered publishing and open access assistant built by [Khalifa University Library](https://library.ku.ac.ae/lib). It helps KU researchers navigate journal selection, self-archiving rights, and research data management — in one place.

---

## ✨ Features

### 📰 Tab 1 — Journal Submission
- 5 detailed journal cards + 10 quick-match suggestions (15 total per query)
- Full Green OA breakdown per journal: Preprint / AAM / Version of Record
- Ranking verified from 2025 journal data (32K+ journals) + OpenAlex enrichment
- Scopus Sources direct links per journal for live metric verification
- Khazna deposit guidance always included

### 🛡 Tab 2 — License Checking
- Version-specific self-archiving policy (3-version breakdown)
- Embargo lengths, licence conditions, risk flags
- Direct deposit guidance for Khazna

### 🗄 Tab 3 — Data Repository
- 4–5 recommended repositories (domain-specific + generalist mix)
- Khazna always first as KU institutional option
- Metadata-first rule: register in Khazna even if data goes elsewhere
- FAIR alignment, certification, cost, embargo support per repository

### 🏛️ Khazna Integration
- KU institutional repository always recommended across all three tabs
- Article and dataset deposit guidance
- Contact: khazna@ku.ac.ae

---

## 🏗️ Architecture

```
GitHub Pages (frontend) ──HTTPS──► HuggingFace Spaces (FastAPI)
                                          │
                              ┌───────────┴──────────────┐
                              │  scimagojr_2025.csv       │
                              │  OpenAlex API (free)      │
                              │  OpenAI API (gpt-4o-mini) │
                              └───────────────────────────┘
```

---

## 🚀 Deployment

### Backend — This Space
1. Add secret: `OPENAI_API_KEY` in Space Settings → Secrets
2. All files are in the Space root and `static/` folder
3. Ping `/api/health` every 5 min via UptimeRobot to prevent cold starts

### Frontend — GitHub Pages
1. Update `HF_BASE` in `static/js/api.js` to your Space URL
2. Push to `gh-pages` branch of `ku-library/researchbee`

---

## 📊 Data Sources

| Source | Used for | Key needed? |
|---|---|---|
| SCImago CSV 2025 | Offline quartile lookup (private) | No — bundled |
| OpenAlex API | Journal enrichment, h-index, citedness | No — free |
| OpenAI API | All AI analysis | Yes |

> Ranking metrics sourced from journal data (2025). Always verify policies on
> [Open Policy Finder](https://openpolicyfinder.jisc.ac.uk) and repositories on
> [re3data](https://www.re3data.org) before deposit.

---

## 🏛️ About

Built by [Khalifa University Library](https://library.ku.ac.ae/lib) as part of the Research Navigator suite.

- 📧 Library: library@ku.ac.ae
- 🏛️ Khazna: khazna@ku.ac.ae
- 🌐 [khazna.ku.ac.ae](https://khazna.ku.ac.ae)
- 📚 [library.ku.ac.ae/lib](https://library.ku.ac.ae/lib)

---

MIT License — Khalifa University Library