Aller au contenu
Notosaurus

Installation avancée

Le greffon Anki est la façon la plus simple d’utiliser Notosaurus. Pour le faire tourner seul, par exemple sur un serveur toujours allumé à la maison, installez-le en autonome ou avec Docker.

Les différences avec le greffon :

  • Notosaurus tourne même quand Anki est fermé ; le téléchargement du .apkg marche toujours.
  • Ajouter à Anki a besoin d’Anki ouvert sur l’ordinateur, avec le greffon AnkiConnect (code 2055492159).
  • Les réglages (/admin.html) sont accessibles depuis le réseau, protégés par un mot de passe d’administration créé à la première visite.

En autonome

Section intitulée « En autonome »

Avec Python 3.13 :

Fenêtre de terminal
git clone https://github.com/cchabanois/notosaurus.git
cd notosaurus
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
.venv/bin/uvicorn app.main:app --host 0.0.0.0

Ouvrez http://localhost:8000 sur l’ordinateur. Pour le téléphone (même Wi-Fi) : ⚙️ → Téléphones, et scannez le QR code.

Docker

Section intitulée « Docker »
Fenêtre de terminal
docker build -t notosaurus .
docker run -p 8000:8000 -v notosaurus-data:/data --env-file .env \
  -e NOTOSAURUS_PUBLIC_URL=http://<ip-de-l-ordinateur>:8000 notosaurus

Dans Docker, Notosaurus ne voit pas l’adresse de l’ordinateur : NOTOSAURUS_PUBLIC_URL la met dans le QR code des téléphones. L’ordinateur lui-même passe aussi par le réseau de Docker : ouvrez ⚙️ → Téléphones et utilisez une fois le lien sous le QR code.

Variables d’environnement

Section intitulée « Variables d’environnement »

Copiez .env.example en .env. Ces variables donnent les valeurs par défaut : ce qui est enregistré dans la page des réglages l’emporte.

Variable Rôle
NOTOSAURUS_LLM service d’IA : gemini, anthropic, openai, openrouter, compatible
GEMINI_API_KEY, ANTHROPIC_API_KEY, OPENAI_API_KEY, OPENROUTER_API_KEY clés d’API
NOTOSAURUS_MODEL le modèle (vide : le choix de Notosaurus pour le service)
NOTOSAURUS_FALLBACK_MODEL modèles Gemini essayés quand le principal est surchargé
NOTOSAURUS_COMPATIBLE_BASE_URL, NOTOSAURUS_COMPATIBLE_API_KEY un autre service compatible OpenAI (Ollama : http://localhost:11434/v1)
NOTOSAURUS_PICTURE_SERVICE, NOTOSAURUS_PICTURE_MODEL le service qui dessine les images des cartes (gemini, openai, openrouter, none ; vide : celui des cartes) et son modèle
NOTOSAURUS_DATA le dossier de données (par défaut : data)
NOTOSAURUS_ANKICONNECT_URL, NOTOSAURUS_ANKICONNECT_KEY AnkiConnect (par défaut : http://localhost:8765)
NOTOSAURUS_PUBLIC_URL l’adresse du QR code des téléphones, quand Notosaurus ne la voit pas (Docker) ; en dehors des adresses IP et de localhost, le seul nom auquel Notosaurus répond