README.md

metadata

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. 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 and repositories on re3data before deposit.

---

🏛️ About

Built by Khalifa University Library as part of the Research Navigator suite.

• 📧 Library: library@ku.ac.ae
• 🏛️ Khazna: khazna@ku.ac.ae
• 🌐 khazna.ku.ac.ae
• 📚 library.ku.ac.ae/lib

---

MIT License — Khalifa University Library