Memium
When you have to stop and look things up, it breaks up your flow. Adding this knowledge to long-term memory builds fluency, and being fluent at something makes it much more fun! The faster you can get from crawling to running, the more enjoyable it is.
Unfortunately, we forget most of what we read, even stuff we care about.
It turns out that if you ask questions of the texts you read, and ask those questions of yourself in the future, you learn much more! But writing questions and quizzing yourself can feel quite mechanical. What if you wrote questions as part of your notes, and then your computer could quiz you in the future? That's the purpose of Memium. It extracts questions from your notes like
Q. Why can spaced repetition result in more enjoyable learning?
A. It enables faster bootstrapping to proficiency, which is more fun!
And adding them to a spaced repetition service like Anki.
This is an implementation of Andy Matuschak's Personal Mnemonic Medium.
Use as an application
If you want to sync markdown notes to Anki, here's how to get started!
- In Anki, install the AnkiConnect add-on
Command line interface
- Install Memium in its own virtual environment with pipx,
> uv tool install memium
- Import your notes!
> memium --input-dir [YOUR_INPUT_DIR] --vault-name [YOUR_VAULT_NAME]
In Docker container
- Install Orbstack or Docker Desktop.
- Setup a container
$INPUT_DIR="PATH_TO_YOUR_INPUT_DIR"
VAULT_NAME="NAME_OF_YOUR_OBSIDIAN_VAULT"
docker run -i \
--name=memium \
-e HOST_INPUT_DIR=$INPUT_DIR \
-v $INPUT_DIR:/input \
--restart unless-stopped \
ghcr.io/martinbernstorff/memium:latest \
memium --input-dir /input --vault-name "$VAULT_NAME"
--vault-name is optional, and is the vault's name as Obsidian shows it on your host, not a path: the "Obsidian" button on each card is resolved by Obsidian on the host, so the container's /input is irrelevant to it. Omit it and the button opens whichever vault is active.
This will start a docker container which updates your deck from $INPUT_DIR. In case of updated files, it will sync the difference (create new prompts and delete deleted prompts) to Anki.
If you want to continuously sync the directory, set the --watch-seconds [UPDATE_SECONDS] argument as well.
Keeping the package update can be a bit of a chore, which can be automated with WatchTower.
Use as library
If you would like to build build your own Python application on top of the abstractions added here, you can install the library from pypi:
uv add memium
Contributing
Setting up a dev environment
- Install Orbstack or Docker Desktop. Make sure to complete the full install process before continuing.
- If not installed, install VSCode
- Press this link
- Complete the setup process
💬 Where to ask questions
| Type | |
|---|---|
| 🚨 Bug Reports | GitHub Issue Tracker |
| 🎁 Feature Requests & Ideas | GitHub Issue Tracker |
| 👩💻 Usage Questions | GitHub Discussions |
| 🗯 General Discussion | GitHub Discussions |
1 maintainer
Metadata
1 maintainer
Release files for memium 1.11.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| memium-1.11.0.tar.gz | 196.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| memium-1.11.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 244.0 kB
Release files / memium-1.11.0.tar.gz
| Download URL | memium-1.11.0.tar.gz |
|---|---|
| Size | 196.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f7a118cd11d7568817ecc703523b921913616ee74b5a5cff14e7122f48a2ee1d
|
|
BLAKE2b-256 checksum How to use checksums |
7de298ba161e0300c1d22d7ae270dcb004008e3f570d761ddbf9435ac0d42b22
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 8, 2026.
Transparency logRelease files / memium-1.11.0-py3-none-any.whl
| Download URL | memium-1.11.0-py3-none-any.whl |
|---|---|
| Size | 47.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3be995c5a62b32e68445a3ce065aa58586370245b0485fe221442c4f1857534b
|
|
BLAKE2b-256 checksum How to use checksums |
6e0c63233c9113341f0cf42220d2df2433896a772c6e27f8e08a740cd0a7b646
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 8, 2026.
Transparency log
