Comment ça marche

Un noyau Python (nokker/) bâti sur trois piliers : un contexte dynamique porté par CortHeXis (nokker/context/, nokker/memory/), un juge de sûreté avec des invariants déterministes évalués avant tout modèle (nokker/qa/), et le multi-modèle avec un palier choisi à chaque tour (nokker/route/, nokker/providers/). Chaque tour est rattaché à un locataire à la frontière (API, Telegram), jamais deviné.

Chaque appel d'outil est classé par effet : lecture, écriture, envoi externe, dépense, destructif. Des invariants déterministes (nokker/qa/) tranchent avant le modèle : envoi externe et dépense → carte ; destructif → carte forte ; envoi de masse → refusé. Une carte forte exige une assertion WebAuthn avec vérification de l'utilisateur (biométrie de l'appareil) ; une carte standard accepte aussi un code à usage unique. Un relecteur automatique peut approuver des écritures bénignes, jamais une carte forte, destructive, d'envoi externe ou de dépense. Tant que la carte attend, l'action n'est pas exécutée.

Un agent de paiement séparé du noyau (payagent/) : le noyau applique budgets et règles du foyer et pose la carte, il ne paie pas. Le mandat est haché puis signé par ta passkey (WebAuthn, vérification de l'utilisateur exigée) ; il fixe le montant, le marchand et l'échéance. L'agent de paiement ne croit pas le noyau : il revérifie lui-même l'appareil, la signature, l'empreinte du mandat et l'échéance avant de payer. Il paie avec une carte virtuelle prépayée dédiée, émise par un établissement régulé, à plafond : le solde que tu y as mis est la limite. Le modèle ne voit jamais le numéro de carte. Drapeau éteint en bêta.

Les notes vivent dans Postgres avec pgvector, en portée profil ou foyer (nokker/memory/). À chaque tour, le contexte dynamique (nokker/context/) rappelle les notes utiles. La consolidation de la nuit s'applique, se rapporte le matin et se défait. L'export de compte est limité à une demande par 24 h ; l'effacement passe par une carte forte, puis la purge suit en moins de 24 h.

CortHeXis (licence Apache 2.0, auto-hébergeable, sans compte) garde un dossier de notes markdown courtes, un fait chacune. Rappel à chaque message, sous-agents compris ; recherche hybride (sens et mots-clés) et multilingue, chaque résultat portant son âge. Une revue relit toute la mémoire et propose des réparations avec un diff, écrites seulement après approbation. L'index se reconstruit depuis les notes. Dans Nokker, c'est le pilier « contexte dynamique » (nokker/context/, nokker/memory/).

Bêta hébergée sur un Kubernetes managé d'OVHcloud, en France. Chaque compte est un locataire isolé dans Postgres : colonne de locataire sur les tables de contenu, RLS activée et forcée (nokker/store/migrations/), locataire fixé à la frontière ; hors d'un contexte de locataire, la lecture échoue au lieu de servir les données d'un autre. Le consentement d'entraînement est un choix séparé, décoché par défaut ; le contenu des connecteurs en est exclu.

Mail en IMAP/SMTP avec un mot de passe d'application, préréglages pour les grands fournisseurs et réglage libre (nokker/connectors/). Agenda en CalDAV (lecture et écriture) ou iCal (lecture). Telegram par bot, avec approbation sur l'appareil. Images lues par un modèle de vision. Domotique (Home Assistant) seulement sur Lokkal : la bêta cloud n'ouvre aucune passerelle vers ta maison.

Un foyer regroupe jusqu'à six comptes ; chacun reste un locataire isolé, avec sa mémoire privée, et partage une mémoire de foyer (nokker/household/). Profils mineurs ouverts par liste blanche pendant la bêta ; une règle de paiement refuse toute dépense d'un mineur que le payeur n'a pas autorisée. Calendrier familial : photo ou PDF lu, carte, puis écriture en CalDAV ou fichier .ics.

Un Compose Docker : le noyau et le web en conteneurs, l'état dans un seul dossier chez toi. Les commandes de code tournent dans un bac à sable Docker, avec des worktrees isolés. L'API locale n'écoute que la machine et exige un jeton local. Installeurs, images et binaires sont signés (signatures Sigstore publiées à côté). Le modèle est au choix : le tien, ou celui que nous proposons.

Noyau sous licence Apache 2.0 ; une partie du code dérive d'un projet d'agent open source sous licence MIT, attribution conservée dans NOTICE. CortHeXis, la mémoire, est aussi sous Apache 2.0. La marque, le nom et le logo ne sont pas couverts par la licence.

Les paliers du foyer sont dans nokker/billing/ : le foyer suit le palier actif de la personne qui paie, et le quota est commun à toute la maison.

Candidatures stockées en Suisse, formulaire protégé contre les robots. Invitation par mail avec un jeton à usage unique valable 7 jours ; en bêta, chaque compte est un locataire isolé.