astrolabe
Astrolabe is a self-hosted, bilingual (Arabic/English) reading room for Markdown and LaTeX notes, featuring live preview editing, graph visualization, spaced repetition tracking, and a blog publishing system.
Ficha actualizada 23 sept 2026, 3:57 · upstream 23 sept 2026, 3:52 · release v3.23.0
Qué es astrolabe
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Astrolabe is an instrument for people who read seriously and write from what they read. It runs as one small Node.js process over an ordinary folder of Markdown and LaTeX files, with everything it knows about your notes read directly from those files. The application provides a live-preview editor with wikilinks and backlinks; a graph view; search that understands Arabic letter forms and diacritics; a book reader driven by vim keys that cites highlights into the note beside it; trackers for books, games, and courses; sigils (daily plans) with streaks and heatmaps; orbits (spaced repetition decks); drawing tools via Excalidraw; LaTeX notes that compile; and a blog publishing system. It is designed to be bilingual by default, with Arabic and English as equal renderings of the same product, featuring mirrored shells, Hijri date support, right-to-left prose behavior in the editor, reading view, and published pages. The vault opens from any browser on your network — phone, laptop, or desktop app are three windows on one vault. No data is converted, wrapped, or stored elsewhere; delete the app tomorrow and the folder remains untouched.
- Personal note-taking with live preview editing
- Bilingual (Arabic/English) documentation and reading room
- Spaced repetition tracking for books and courses
- Daily planning via sigils with streaks and heatmaps
- LaTeX document creation and rendering
- Drawing notes using Excalidraw integration
- Public blog publishing from a private vault
- Offline reading sessions on mobile devices
- Runs as a single Node.js process over an ordinary Markdown/LaTeX folder with no external dependencies
- Bilingual design with Arabic and English as equal renderings of the same product
- Live preview editor with wikilinks, backlinks, callouts, KaTeX math rendering, and vim mode
- Spaced repetition tracking via Anki-compatible decks with daily limits
- Sigils (daily plans) with streaks, heatmaps, and customizable icons/banners
- Graph view of vault structure using a hand-rolled force simulation canvas
- Search that understands Arabic diacritics and letter forms without transliteration
- Live file watching for real-time updates across the vault
- Requires Node.js ≥ 24 to run, which may not be available on all systems
- Arabic rendering is limited to what is rendered in the editor and reading view; full RTL support for published pages requires server-side configuration
- No built-in collaboration or real-time editing — multiple users must share a single vault
- LaTeX compilation depends on external packages installed locally
- Blog mode is read-only by default and requires manual publishing to make content public
- Offline reading sessions are limited to the admin session only; edits made offline are not persisted after logout
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
To deploy, clone the repository, install dependencies with `npm install`, start with `npm start` on port 6801. For production: set an admin password using `npm run hash-password`, configure `.env` with a session secret and public layout (blog or custom), enable HTTPS via a reverse proxy at localhost:6801, and optionally use Docker Compose for orchestration. The vault is stored as a local folder; no database is required. For the desktop app, set your name and icon in Settings → This device → This app to bake them into the executable.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.