🚀 Getting Started

Everything you need to install EuKosmos, run it for the first time, and set up your ADS API token. Takes about 3 minutes from zero to a fully working research workspace.

Installation

python --version   # must be 3.8 or higher

git clone https://github.com/rmajidul/eukosmos
cd eukosmos
pip install flask requests

python serve.py
# [DB] eukosmos.db ready (0 entries)
# [OK] Serving at http://localhost:8080

🗺 App Overview

EuKosmos is a browser-based app served from your own machine. It organises your research into 15 dedicated sections — all data stays as plain JSON files on your hard drive, never uploaded anywhere.

Interface at a Glance

Your Data Is Plain Files

📚 Literature Papers

The core section. Paste any paper identifier — DOI, arXiv ID, ADS bibcode, or InspireHEP key — and EuKosmos automatically fetches complete metadata from up to 6 databases. Or bulk-import your entire .bib library in one click.

Adding a Single Paper

The 6-Database Enrichment Cascade

Each database contributes only what the previous ones didn't find — no duplication, maximum coverage per query. The fetch log shows exactly which database contributed each field.

Bulk BibTeX Import

Reading Status

Click the status badge on any card to cycle through. Filter by status in the toolbar to build a personal reading queue.

📑 Reference Styles & BibTeX

Export your master .bib library — or a project-specific one — ready for Overleaf or any LaTeX editor. Format references in MNRAS, APA, Nature, and ~40 built-in styles instantly. Unlock all 10,000+ CSL styles with one click.

Two Export Levels

Citation Style Tiers

Auto-Generated Citekeys

📝 Research Notes

A professional Markdown editor with live split-pane preview. Write equations using standard math syntax, embed images, link to papers, and export to PDF or Word .docx. Your running lab notebook — permanently local, instantly searchable.

Editor Modes

Markdown Quick Reference

# Heading 1     ## Heading 2     ### Heading 3
**bold**         *italic*         ~~strikethrough~~
`inline code`    [link](url)      ![alt](image)

- Bullet list    1. Numbered      > Blockquote
---  (divider)   | Table | Col |
                 |-------|-----|
                 | Cell  |  A  |

# Equations (render live in preview)
$E = mc^2$                       ← inline equation
$$\int_0^\infty f(x)\,dx$$       ← display block
$$F_\nu \propto \nu^{-\alpha}$$   ← spectral index

Adding Images

Keyboard Shortcuts

☑️ Checklists

Multi-step checklists with per-step due dates that feed directly into your unified calendar. Built-in templates for ALMA proposals, ERC grants, visa applications, and lab protocols. Generate any checklist from any document using the AI hint workflow.

Step Status System

Click any checkbox to cycle states. Overdue steps turn red automatically. Progress bar shows % done, blocked, and waived in real-time — updates on every click without page reload.

Built-in Templates

AI-Generated Checklists — From Any Document

💼 Job Register

Track every academic job application from first click to offer. Manage referees across all applications, auto-generate deadline-aware email templates, and print complete per-referee document packages.

Application Lifecycle

Reference Letter Types

Referee Workflow

📋 Proposals

Track all grant proposals and observing time requests. A visual dashboard shows your portfolio at a glance: status counts, agency distribution, role breakdown, and upcoming deadlines — all automatically linked to the calendar.

📅 Calendar & Todo

One calendar that collects deadlines from every section automatically — you add a deadline once in Jobs or Checklists and it appears in the calendar without any extra step. Import external .ics feeds for department or collaboration schedules.

What Feeds In Automatically

🎓 CV Builder

Build your structured academic CV directly inside EuKosmos. Papers auto-populate from your library. Export as a formatted Word .docx ready for job applications — no copy-pasting, no reformatting.

💡 Ideas

A hypothesis tracker. Capture research ideas before they vanish, rate their feasibility, track their journey from "shower thought" to published paper, and link them to papers in your library.

⌨️ Code Library

A personal snippet library for analysis scripts, shell one-liners, Python functions, SQL queries, and useful tools. Searchable by language and tags. Never dig through old notebooks looking for that Astropy snippet again.

👥 Collaborators & 🖼 Photos

✅ Todo List

Fast priority-based task manager. Todos with due dates appear in the unified calendar. For complex multi-step tasks, use Checklists — not Todos.

🔍 Full-Text Search

Global search across all 15 sections simultaneously. Powered by SQLite FTS5 with BM25 relevance ranking. Results return in under 50ms even with 10,000 papers.

📄 BibTeX & Overleaf Workflow

EuKosmos fits naturally into any LaTeX/Overleaf workflow. Add papers in EuKosmos, export your .bib, drop it into Overleaf, cite with auto-generated citekeys. Re-export whenever you add more papers.

💾 Backup & Sync

Your EuKosmos data is a folder of plain files. Back up or sync it exactly like any other folder — no special tools, no cloud account required.