ELPA Logo GNU-devel ELPA: gnosis

gnosis Atom Feed

Description
Linked notes and spaced repetition
Latest
gnosis-0.13.0.0.20260923.19.tar (.sig), 2026-Sep-23, 1.27 MiB
Maintainer
Thanos Apollo <public@thanosapollo.org>
Other versions:
release version
Website
https://git.thanosapollo.org/emacs-gnosis
ELPA's Repository
CGit or Gitweb
All Dependencies
compat (.tar)
keymap-popup (.tar)
Manual
gnosis

To install this package from Emacs, use package-install or list-packages.

Full description

1. Gnosis

Gnosis is a note-taking and self-testing system for Emacs. Write linked Org notes, turn what you want to remember into questions, and review with spaced repetition or practice a topic directly.

Notes remain plain Org files. SQLite stores their index, questions, schedules and review history. No server or AI service is required.

1.1. Notes and questions

A node is an Org note or heading with an :ID:. A thema (plural themata) is a question. Link a thema to its source notes to review a topic together or return to the source when an answer needs context.

  • Write and link notes, keep a journal, and find material by topic or tag.
  • Use basic questions, multiple choice, cloze deletions, images and image occlusion. Interactive 3D questions are optional.
  • Review with FSRS-6 scheduling, or practice selected questions without changing their spaced-repetition schedules.
  • Add explanations and source links shown after answering. Edit weak questions as you study.

1.2. Agent integration

Optional Emacs Lisp interfaces let an external agent find questions, read their sources, propose tag and source-link changes, and start native practice sessions. Organization changes use preview/apply operations; stale edits and writes during an active review are refused.

An agent can help you find questions for a topic or organize existing material. You still answer in Gnosis. Free-response questions can also use an optional rubric-based evaluator; its verdict remains subject to review and override.

The interfaces are provider-independent: gnosis-agent handles practice, gnosis-agent-content handles discovery and organization, and gnosis-agent-eval handles response evaluation. See their docstrings for the API. Models and credentials are configured separately.

1.3. Installation

Install from GNU ELPA: 

M-x package-refresh-contents
M-x package-install RET gnosis RET
M-x gnosis-dashboard

Requires Emacs 29.1 or later with SQLite support. Check with M-: (sqlite-available-p). Emacs installs the Lisp dependencies; Python is not needed for ordinary use.

Read the manual for configuration and usage, or open the installed version with C-h i g (gnosis) RET. The source checkout may contain features not yet available in the ELPA release.

Before opening an existing database with upgraded code, back up the database, Org files and media. See Database Upgrades and Rollback.

1.4. Optional 3D questions

The separate canvas-3d backend requires a graphical Emacs with canvas support (Emacs 32 development builds), Python 3.12–3.14 and EGL/OpenGL 3.3. Only Linux EGL is currently verified. It is not included in the ELPA package, and anatomical models are not bundled.

See the canvas-3d setup guide for installation and checks.

Old versions

gnosis-0.13.0.0.20260921.4.tar.lz2026-Sep-21 225 KiB
gnosis-0.13.0.0.20260920.2.tar.lz2026-Sep-20 220 KiB
gnosis-0.12.0.0.20260919.62.tar.lz2026-Sep-19 217 KiB
gnosis-0.12.0.0.20260915.0.tar.lz2026-Sep-15 201 KiB
gnosis-0.11.0.0.20260915.5.tar.lz2026-Sep-15 200 KiB
gnosis-0.9.0.0.20260324.41002.tar.lz2026-Mar-2490.2 KiB
gnosis-0.8.0.0.20260304.151947.tar.lz2026-Mar-0475.8 KiB
gnosis-0.7.0.0.20260224.120212.tar.lz2026-Feb-2454.7 KiB
gnosis-0.6.0.0.20260202.35243.tar.lz2026-Feb-0241.2 KiB
gnosis-0.4.10.0.20241212.14747.tar.lz2025-Jan-1540.9 KiB

News

1. 0.13.0

1.1. Upgrading

  • Require keymap-popup 0.4.4 for post-answer popup ownership and cleanup.
  • Upgrade released schema 10 to schema 11 to add optional thema rubrics. Existing answers, schedules and study history are preserved. Released schema 8 and 9 databases upgrade through the existing migration steps.
  • Back up the database, Org files and media before the first database open with this version. Downgrading to 0.12.0 requires its matching schema-10 backup, not a database already upgraded to schema 11.
  • Portable content format 5 includes ordinary managed images. Exports carry image bytes, but not original PDFs, region/occlusion cards or 3D models. Back up managed assets with gnosis-backup-data and preserve original PDFs and other external source files separately.

1.2. Review and practice

  • Add rubric-based free-response questions with asynchronous evaluation. Reviewers can inspect and override provisional feedback before accepting a result. Evaluation errors and cancellation do not record failed grades. The optional evaluator receives the question, reference answer, rubric and response; configure its backend before using this question type.
  • Show post-answer actions in a popup with the pending result and next review date. Practice feedback reports that the schedule is unchanged.
  • Add practice-completion notifications and scheduled review from completed practice summaries through gnosis-review-summary-scheduled, preserving separate practice evidence.
  • Preserve the answered occurrence through editing, source navigation and callbacks. Replaced sessions, deleted cards and foreign databases cannot receive stale grades or actions.
  • Complete typing exercises whose target ends with a newline.

1.3. Authoring and illustrations

  • Attach lecture illustrations to explanations with gnosis-lecture-attach, including local PDF page extraction and links to the original source.
  • Preserve complete drafts, source links and literal Org content through narrowed editing, validation, cancellation and interrupted saves.
  • Resolve thema tags outside narrowing without changing question headings.
  • Preserve Anki model fields and note kinds, and refuse imports whose destination database changes while input is being collected.
  • Preserve managed image paths and draft resources; improve model picking precision and reject geometry changes during target publication.

1.4. Journals, navigation and reliability

  • Keep journal capture and template insertion inside the selected date, including files visited through symbolic or hard links.
  • Preserve exact node selections, native metadata and source targets; reconcile external file changes without indexing stale buffer contents.
  • Preserve dashboard selection, sorting and rendering ownership across prompts and buffer changes. Reduce repeated topic and study-day reads.
  • Validate scheduler ownership constraints when opening databases and keep startup independent of optional Git integration.
  • Expand native command-loop regression coverage and require explicit test completion receipts so interrupted suites cannot report success.

2. 0.12.0

2.1. Upgrading

  • Upgrade released schema 9 to schema 10 to retain practice encounter evidence. Released 0.10.6 databases still upgrade through schema 9. Existing content, schedules and study history are preserved; missing historical answers are not invented.
  • Back up before the first database open with this version. Downgrading to 0.11.0 requires its matching pre-upgrade database backup, not a schema-10 database.

2.2. Fixes

  • Populate dashboard statistics on first startup without requiring a previous review session to load their implementation.
  • Refuse native thema saves that would discard explanation headings or

… …