Documentation de Libris Translate · Libris Translate documentation
En français
Libris Translate (Libris en abrégé) traduit des livres entiers et des séries avec le modèle de langage de votre choix, sur votre propre serveur. Partez de ce que vous voulez faire. Chaque page dit à qui elle s’adresse et renvoie aux autres plutôt que de les répéter. Les documents destinés aux utilisateurs et aux administrateurs existent en français ; ceux destinés aux développeurs (architecture, développement, système de conception, exploitation) sont pour l’instant en anglais seulement.
Les preuves ponctuelles d’audit et les listes de contrôle d’une ancienne livraison restent dans les issues et merge requests GitLab qui les ont produites. Elles ne font pas partie de cette documentation vivante : une procédure encore valable est intégrée au guide d’exploitation ou de développement correspondant.
Installer et faire tourner Libris
| Je veux… | Lire |
|---|---|
| Installer Libris avec Docker depuis le registre licencié, sans archive, puis traduire un premier livre | docker.fr.md |
| Retrouver un réglage : variables d’environnement et réglages modifiables dans l’interface | configuration.fr.md |
| Comprendre la licence : activation, cycle de quota, droits de la formule, machines, certificat perpétuel | configuration.fr.md › Licence |
| Mettre à jour, surveiller, maîtriser les coûts, lire les journaux et dépanner une installation | operations.md (en anglais) |
| Sauvegarder et restaurer ma bibliothèque | backup.fr.md |
| Faire tourner une démo publique en lecture seule | demo.fr.md |
| Brancher Codex ou un compte ChatGPT comme provider de modèle | codex.fr.md |
| Ajouter OpenViking comme mémoire externe | openviking.fr.md |
| Permettre la connexion avec un compte LDAP ou Active Directory | ldap.fr.md |
Utiliser Libris
| Je veux… | Lire |
|---|---|
| Apprendre toute l’interface | user-guide.fr.md |
| Déposer les livres finis dans Calibre-Web, Komga ou Kavita | publication.fr.md |
| Créer des comptes locaux, gérer les accès et distinguer les identités SSO | Utilisateurs, API des comptes |
| Configurer un serveur de courriel et examiner les échecs d’envoi | Administrer les courriels, réglages SMTP |
| Lire et corriger un chapitre sans l’éditeur côte à côte | Lecteur intégré, guide d’utilisation |
| Lancer une série entière en pilote automatique, ou la mettre en pause, en une action | Lancer le pilote automatique, contrat d’automatisation |
| Comprendre ce que fait le pilote automatique, de l’import au résultat final, et comment le désactiver | autopilot.fr.md |
| Envoyer des livres ou des chapitres depuis un script et récupérer la traduction | api.fr.md |
| Piloter Libris depuis un agent de code (opencode, Claude Code, Codex) par MCP | mcp.fr.md |
| Générer un client, ou lire le contrat de l’API en OpenAPI 3.1 | openapi/libris-v1.json, et le client d’exemple examples/libris_client.py |
Comprendre et modifier Libris (en anglais)
| Je veux… | Lire |
|---|---|
| Comprendre les composants, la chaîne de traitement, le modèle de données et la conception de la sécurité | architecture.md |
| Préparer un environnement de développement, lancer les tests, comprendre la CI et publier une version | development.md |
| Construire des écrans cohérents avec le reste de l’application | design-system.md |
| Mesurer la qualité réelle des traductions produites, au-delà de la suite de tests | evaluations/corpus.md |
Projet
- libris-translate.com : le site officiel, en français et en anglais (formules, essai, installation, support : support@libris-translate.com).
- CHANGELOG.fr.md : ce qui a changé à chaque version depuis la 0.8.0, avec les notes de mise à jour ; l’historique complet est dans CHANGELOG.md (en anglais).
- SECURITY.md : versions prises en charge et signalement privé d’une vulnérabilité (en anglais).
- THIRD_PARTY_NOTICES.md (en anglais).
In English
Libris Translate (Libris for short) translates whole books and series with the language model you choose, on
your own server. Start with the task you have in mind. Each page says who it is for and links to the others instead of repeating
them. Documents for users and administrators exist in English and in French (*.fr.md); the user guide and the
library publication guide exist in French only.
Point-in-time audit evidence and old release checklists stay with the GitLab issues and merge requests that produced them. They are not part of this living documentation; any procedure that remains useful belongs in the corresponding operations or development guide.
Install and run Libris
| I want to… | Read |
|---|---|
| Install Libris from the licensed registry with Docker, without an archive, sign in and translate a first book | docker.md |
| Look up a setting: environment variables and the settings editable in the interface | configuration.md |
| Understand the licence: activation, quota cycle, what a plan grants, machines, perpetual certificate | configuration.md › Licence |
| Update, monitor, control costs, read logs and troubleshoot a running installation | operations.md |
| Back up and restore my library | backup.md |
| Run a public read-only demo | demo.md |
| Connect Codex or a ChatGPT account as a model provider | codex.md |
| Add OpenViking as an external memory | openviking.md |
| Have another model judge every translated passage and correct its errors; benchmark a model or a release | quality.md (français) |
| Let people sign in with their LDAP or Active Directory account | ldap.md |
Use Libris
| I want to… | Read |
|---|---|
| Learn the whole interface, in French | user-guide.fr.md |
| Create local accounts, manage access and distinguish SSO identities | Users, account API |
| Configure a mail server and inspect delivery failures | Mail administration, SMTP settings |
| Read and correct a chapter without the side-by-side editor | Integrated reader, user guide |
| Start a whole series on autopilot, or pause it, in one action | Starting a whole series, automation contract |
| Understand what the autopilot does, from import to the final result, and how to turn it off | autopilot.md |
| Send books or chapters from a script and get the translation back | api.md |
| Drive Libris from a coding agent (opencode, Claude Code, Codex) over MCP | mcp.md |
| Generate a client, or read the API contract in OpenAPI 3.1 | openapi/libris-v1.json, and the example client examples/libris_client.py |
Understand and change Libris
| I want to… | Read |
|---|---|
| Understand the components, the pipeline, the data model and the security design | architecture.md |
| Set up a development environment, run the tests, understand CI and cut a release | development.md |
| Build interface screens that match the rest of the application | design-system.md |
Project
- libris-translate.com: the official website, in English and French (plans, trial, installation, support: support@libris-translate.com).
- CHANGELOG.md: what changed in each release, including upgrade notes (CHANGELOG.fr.md: the same from 0.8.0 on, in French).
- SECURITY.md: supported versions and how to report a vulnerability privately.
- THIRD_PARTY_NOTICES.md.