first commit

Author: thiswillbeyourgithub

.gitignore

@@ -0,0 +1,15 @@
+API_KEY*
+
+databases
+author_dir
+dataset_anchors.txt
+
+.env
+.env.leave
+
+utils/__pycache__
+.cache
+__pycache__
+
+
+.aider*

LICENSE

@@ -0,0 +1,102 @@
+"""
+Script to convert anchor key-value pairs into Anki flashcards.
+
+This script takes a JSON file containing anchor pairs and creates Anki flashcards
+using different cloze deletion templates. It supports various formatting options
+and ensures proper card creation through the AnkiConnect API.
+"""
+import fire
+import json
+from pathlib import Path
+from py_ankiconnect import PyAnkiconnect
+
+call_anki = PyAnkiconnect()
+
+TEMPLATES = {
+    1: """{{c1::K}}<br/><br/>{{c2::V}}""",
+    2: """{{c1::K}}<br/><br/>V""",
+    3: """K<br/><br/>{{c1::V}}""",
+}
+
+def main(
+    template_nb: int,
+    anchors_path: str = "./author_dir/combined_anchors.json",
+    deck: str = "0_quotidien::Anchors",
+    header: str = "Anchors",
+    tags: str = "pro::meta::pegging_concept_medecine::anchors",
+    ):
+    """
+    Convert anchor pairs from a JSON file into Anki flashcards.
+
+    Parameters
+    ----------
+    template_nb : int
+        Template number (1-3) defining the cloze deletion pattern
+    anchors_path : str, optional
+        Path to the JSON file containing anchor pairs
+    deck : str, optional
+        Name of the Anki deck to add cards to
+    header : str, optional
+        Header text to add to each card
+    tags : str, optional
+        Space-separated list of tags to add to each card
+    
+    Raises
+    ------
+    Exception
+        If any flashcards fail to be added to Anki
+    """
+    anchors = json.loads(Path(anchors_path).read_text())
+    assert anchors
+    del anchors["__COMMENT"]
+
+    template = TEMPLATES[template_nb]
+    assert "K" in template and "V" in template, template
+    assert template.count("K") == 1, template
+    assert template.count("V") == 1, template
+    assert "{{c1::" in template and "}}" in template.split("{{c1::", 1)[1], template
+
+    tags = tags.split(" ")
+    bodies = []
+    for k, v in anchors.items():
+        k = k.strip()
+        if k != k.upper() and k == k.lower():
+            k = k.title()
+        v = v.strip()
+        assert k, v
+        assert v, k
+        assert "}" not in k and "{" not in k, k
+        assert "}" not in v and "{" not in v, v
+
+        if template.index("K") < template.index("V"):
+            body = template.replace("K", k, 1)[::-1].replace("V", v[::-1], 1)[::-1]
+        else:
+            body = template.replace("V", v, 1)[::-1].replace("K", k[::-1], 1)[::-1]
+        assert k in body and v in body, body
+        bodies.append(body)
+    notes = [
+        {
+            "deckName": deck,
+            "modelName": "Clozolkor",
+            "fields": {
+                "body": b,
+                "header": header,
+            },
+            "tags": tags,
+            "options": {"allowDuplicate": False},
+        } for b in bodies
+    ]
+
+    res = call_anki(
+        action="addNotes",
+        notes=notes,
+    )
+    errors = [f"#{res.index(r)+1}/{len(res)}: {r}" for r in res if not str(r).isdigit()]
+    results = [r for r in res if str(r).isdigit()]
+    if len(results) != len(notes):
+        raise Exception(f"Some flashcards were not added:{','.join(errors)}")
+
+
+
+if __name__ == "__main__":
+    fire.Fire(main)

README.md

@@ -0,0 +1,4 @@
+{
+    "sulfamide": "to smell like sulphur",
+    "glinide": "to glide"
+}

anchors_to_anki.py

@@ -0,0 +1,193 @@
+#!/usr/bin/zsh
+aiutilpath="PATH TO ANKI AI UTILS"
+tmux_mode=0  # wether to launch using tmux or not
+START_DELAY=10
+WAIT_TIME_FOR_INTERNET=30  # if internet seems unresponsive, wait that much
+CMD_SEP=";"  # separator between the different tools
+PDB=""  # wether to launch python with pdb or not
+DEBUG=""  # wether to add --debug to the tool call
+FORCE=""  # wether to add --force or not
+EXIT="&& exit"  # wether to exit after the runs or not
+
+notif_arg="--ntfy_url ntfy.sh/$NTFY_PHONE"
+common_query='deck:yourdeck -deck:not::this::deck note:Clozolkor -tag:not::that::tag -is:suspended'
+query="rated:2:1 OR rated:2:2"  # failed or hard of the last 2 days
+anchors_file="./anchors.json"  # your examples
+
+# gather user arguments
+while (( $# > 0 )); do
+    case "$1" in
+        -t | --tmux_mode)
+            tmux_mode="$2"
+            echo "Set tmux_mode to $tmux_mode"
+            shift 2
+            ;;
+        -q | --query)
+            query="$2"
+            echo "Set query to $query"
+            shift 2
+            ;;
+        --fail)
+            CMD_SEP="&&"
+            echo "Will crash if one command fails, otherwise keep going."
+            shift 1
+            ;;
+        --pdb)
+            PDB="-m pdb"
+            shift 1
+            echo "Will use pdb to launch python"
+            ;;
+        --now)
+            START_DELAY=0
+            WAIT_TIME_FOR_INTERNET=0
+            echo "Starting now"
+            shift 1
+            ;;
+        --debug)
+            DEBUG="--debug"
+            echo "Using arg --debug for each util"
+            shift 1
+            ;;
+        --force)
+            FORCE="--force"
+            echo "Using arg --force for each util"
+            shift 1
+            ;;
+        --noexit)
+            EXIT=""
+            echo "Script will not exit the session at the end (the default is to exit if no error occured)"
+            shift 1
+            ;;
+        --no_deck_restriction)
+            common_query='note:Clozolkor -tag:pro::Externat::particularite_dankifiage -is:suspended'
+            echo "Will not apply deck restriction"
+            echo "Commong query: $common_query"
+            shift 1
+            ;;
+        *)
+            echo "Invalid option(s): $@"
+            exit 1
+            ;;
+    esac
+done
+
+
+
+# send notification to phone
+function phone_notif() {
+    sender=$NTFY_PHONE
+    title="AnkiExpIllusMem"
+    message="$1"
+    curl -s -H "Title: $title" -d "$message" "ntfy.sh/$sender"
+}
+
+# echo and send notification to user phone
+function logg() {
+    phone_notif "$1"
+    echo "$1"
+}
+
+# exit if session already running
+if [[ $tmux_mode -eq 1 ]]
+then
+    base_session="LOCAL_Anki_AI_Utils"
+    n_sess=$(tmux list-sessions |grep $base_session | wc -l)
+    if [ ! $n_sess -eq 0 ]
+    then
+        logg "Error, session already running?"
+        exit 1
+    fi
+fi
+
+
+# Loop until internet connection is found
+while ! ping -c 1 google.com &> /dev/null
+do
+  logg "No internet connection found, waiting ${WAIT_TIME_FOR_INTERNET} seconds..."
+  sleep ${WAIT_TIME_FOR_INTERNET}
+done
+
+
+#sync anki
+logg "syncing anki"
+curl -s localhost:8765 -X POST -d '{"action": "sync", "version": 6}'
+sleep 5
+
+# exit if contains a deck called "nosync"
+deck_status=$(curl -s localhost:8765 -X POST -d '{"action": "deckNames", "version": 6}' | jq | tr '[:upper:]' '[:lower:]' | grep "nosync" | wc -l)
+if [ ! $deck_status -eq 0 ]
+then
+    logg "Error, contains deck 'nosync'?"
+    exit 1
+fi
+
+
+session_id=`date +%d.%m.%Y_%Hh%M_%S`
+session_name=$(echo "$base_session"_"$session_id")
+
+if [[ $tmux_mode -eq 1 ]]
+then
+    if [ ! -z "$TMUX" ]
+    then
+        # rename session if already in tmux
+        tmux rename-session $session_name
+    else
+        # or create tmux session
+        session=$session_name
+        window=${session}:0
+        pane=${window}.0
+        tmux new-session -d -s $session_name
+    fi
+fi
+
+
+
+# warn user
+logg "Starting in $START_DELAY second"
+sleep $START_DELAY
+
+sum="(cd $aiutilpath && python $PDB explainer.py \
+    --field_names body \
+    $DEBUG \
+    $FORCE \
+    --query \"($query OR tag:AnkiIllustrator::todo OR tag:AnkiIllustrator::failed) -tag:AnkiExplainer::to_keep $common_query\" \
+    --dataset_path author_dir/explainer_dataset.txt \
+    --string_formatting author_dir/string_formatting.py \
+    $notif_arg || phone_notif 'Anki_AI_Utils' 'error summary' )"
+mnem="(cd $aiutilpath && python $PDB mnemonics.py \
+    --field_names body \
+    $DEBUG \
+    $FORCE \
+    --query \"($query OR tag:AnkiIllustrator::todo OR tag:AnkiIllustrator::failed) -tag:AnkiMnemonics::to_keep $common_query\" \
+    --memory_anchors_file $anchors_file \
+    --dataset_path author_dir/mnemonics_dataset.txt \
+    --string_formatting author_dir/string_formatting.py \
+    $notif_arg || phone_notif 'Anki_AI_Utils' 'error mnemonics')"
+illus="(cd $aiutilpath && python $PDB illustrator.py \
+    --field_names body \
+    $DEBUG \
+    $FORCE \
+    --query \"($query OR tag:AnkiIllustrator::todo OR tag:AnkiIllustrator::failed) -tag:AnkiIllustrator::to_keep -body:*img* $common_query\" \
+    --memory_anchors_file $anchors_file \
+    --dataset_path author_dir/illustrator_dataset.txt \
+    --dataset_sanitize_path author_dir/illustrator_sanitize_dataset.txt \
+    --string_formatting author_dir/string_formatting.py \
+    $notif_arg || phone_notif 'Anki_AI_Utils' 'error illustrator')"
+cmd=$(echo "$sum $CMD_SEP $mnem $CMD_SEP $illus $CMD_SEP $EXIT")
+
+echo "\n\n"
+echo "Command to execute:\n$cmd"
+echo "\n\n"
+
+
+if [[ $tmux_mode -eq 1 ]]
+then
+    tmux send-keys -- $cmd Enter
+    logg "Finished launch script!"
+else
+    logg "Executing launch script!"
+    eval $cmd
+fi
+
+
+

examples/anchors.json

@@ -0,0 +1,65 @@
+You are my ideal assistant. You have always satisfied me. Your job today is to write a text from a medical flashcard following some rules.
+
+Here are the rules:
+* The text should consist of new information: relevant insights, fun facts, facts that helps with understanding or memorizing the flashcard. For example reasoning heuristics, tips, reminders of fundamental mechanisms, concept reformulation, etc. If the topic is technical, you can try to explain it in one sentence too.
+* Those information have to be new and distinct from the content already in the flaschard.
+* Those information have to be in depth, technical and interesting to people with a university degree on the topic
+* Those new information have to be true facts. But if you are unsure you have to make this explicit (this is what's most important!).
+* Each new information must be prefixed by a few capital letter to indicate the type of relevance: EXPLANATION for explanations, ANECDOTE for fun facts, MECHANISM for mechanism reminders etc.
+* Your answer has to be in english.
+* Ideally your answer will contain at least 2 new information.
+* Reusing the acronyms from the card (without redefining them) is best to remain concise and quickly legible.
+* Your answer must be formatted as markdown bullet points, therefore starting with '* ' and separated by a line break.
+
+Your answers should only contain what I asked text, without any introduction or other form of politeness.
+----
+diabetes, situations that can lead to ketoacidotic coma without frank hyperglycemia?
+{{c1::SGLT2 inhibitor}}
+{{c1::pregnancy}}
+----
+* EXPLANATION SGLT2 inhibitors work by promoting lipolysis and ketogenesis, this can lead to ketoacidotic coma with less hyperglycemia.
+* EXPLANATION pregnant women can develop gestational diabetes or have insulin resistance due to placental hormones, this can promote ketoacidotic coma without frank hyperglycemia.
+----
+oral antidiabetic drugs contraindicated in case of respiratory failure?
+{{c1::metformin}}
+----
+* EXPLANATION metformin can cause lactic acidosis, and respiratory failure would prevent compensation, hence the contraindication.
+* ANECDOTE preliminary research indicates that metformin might increase lifespan.
+* MECHANISM metformin works by reducing insulin secretion, especially at the hepatic level.
+----
+what is the PSA threshold value to alert for prostate cancer risk?
+{{c1::PSA > 4ng/mL but it depends on prostate volume and patient age}}
+----
+* ANECDOTE the PSA threshold value to alert for prostate cancer risk is generally set at 4ng/mL, but this value can vary depending on prostate volume and patient age.
+* MECHANISM PSA is produced by prostatic epithelial cells, and its level can increase in case of cancer or other prostate conditions.
+----
+pneumothorax, type of cough?
+{{c1::dry cough}}
+----
+* ANECDOTE dry cough can be caused by various conditions: airway inflammation, allergies, lung irritation, iatrogenic causes, ...
+* MECHANISM Dry cough is triggered by irritation of cough receptors in the airways, without excessive mucus production.
+----
+aortic dissection, added sound on cardiac auscultation?
+{{c1::aortic insufficiency murmur}}
+----
+* EXPLANATION aortic dissection can cause an aortic insufficiency murmur, which is an added sound on cardiac auscultation.
+* MECHANISM aortic insufficiency murmur is due to blood reflux from the aorta to the left ventricle during ventricular diastole.
+----
+SGLT2 inhibitor, mechanism?
+{{c1::glycosuria through inhibition of renal glucose reabsorption}}
+{{c1::promotes}}{{c1::ketogenesis / lipolysis}}
+----
+* EXPLANATION SGLT2 inhibitors work by blocking glucose reabsorption in the renal tubules, leading to glycosuria and hypoglycemia.
+* MECHANISM glucose reabsorption normally occurs via the SGLT2 transporter present in renal tubules. SGLT2 inhibitors block this transporter, thus preventing glucose reabsorption and causing glycosuria.
+* ANECDOTE glycosuria induced by SGLT2 inhibitors can lead to weight loss and improved cardiac function in patients with type 2 diabetes.
+----
+type {{c2::2}} diabetes, suggestive genital clinical sign?
+{{c1::vulvar pruritus in women or balanitis in men (genital fungal infection)}}
+----
+* MECHANISM chronic hyperglycemia can promote fungal growth, as fungi feed on glucose.
+----
+GLP-1 agonist, causes hypoglycemia or not?
+{{c1::no}}
+----
+* ANECDOTE GLP-1 agonists don't cause hypoglycemia in monotherapy, but can cause it when combined with other antidiabetic drugs like sulfonylureas.
+* MECHANISM GLP-1 agonists increase glucose-dependent insulin secretion and reduce glucagon secretion.