opsiom-cli 1.3.0__tar.gz → 1.5.0__tar.gz

opsiom_cli-1.5.0/.env

@@ -0,0 +1 @@
+TOKEN_PYPI=pypi-AgEIcHlwaS5vcmcCJDI3YTY0YTk5LTExZDktNDFlOS04ZGE4LTU1MWFmNDcwZTg1MAACKlszLCJjYzExY2QyYy00ODg4LTRlOTItOTNmYy00NTdhMDhlMWQ5NjQiXQAABiDBNDAJrhWz9Rt11yQPXO1klHHZCcHTEsImiD4G6FOTWA

opsiom_cli-1.5.0/CHANGELOG.md

@@ -0,0 +1,36 @@
+# Changelog
+
+## 1.5.0
+
+### Ajouts
+- Sous-commandes `opsiom doctor` (diagnostic), `opsiom paths` (emplacements des fichiers) et `opsiom configure`.
+- Question unique : `opsiom -p "…"` et `cat fichier | opsiom`.
+- Options `-m/--model` et `--logo` (le repère graphique n’est plus affiché par défaut).
+- Commandes de session `/retry`, `/copy`, `/doctor`.
+- Saisie multiligne avec `"""`.
+- Configuration initiale guidée : URL vérifiée, avertissement pour `http://` distant, clé API saisie masquée.
+- Message explicite quand le serveur est injoignable, avec les actions à tenter.
+- Packaging : `pyproject.toml`, point d’entrée `opsiom`, tests `pytest`.
+
+### Corrections
+- `/save` : le nom de fichier est confiné au dossier des transcriptions (plus de `../` ni de chemin absolu).
+- Fichiers `config.json` et `usage.json` écrits de façon atomique, avec droits 600.
+- Une connexion Octix refusée n’est plus prise pour une réussite lorsque le Space redirige vers `/login`.
+- Une réponse interrompue avant l’évènement de fin est signalée comme erreur.
+- Après une reconnexion Octix, le message est renvoyé automatiquement.
+- Les réponses conservent leurs retours à la ligne et leur indentation (listes, blocs de code).
+- Les codes de couleur ne perturbent plus la largeur du prompt (readline).
+- `/model <nom>` refuse les modèles inconnus.
+- L’historique de saisie est sauvegardé même en cas d’erreur.
+- Les connexions HTTP sont fermées proprement après chaque réponse.
+
+### Changements
+- Interface en français avec vouvoiement partout.
+- En-tête compact (quatre lignes) et repère visuel entre la question et la réponse.
+- Pied de réponse sur une ligne : durée et quota.
+- Symboles ASCII de repli et respect de `NO_COLOR`.
+- Emplacements des fichiers via les conventions de chaque système (`APPDATA` sous Windows, `XDG` ailleurs).
+- Le quota n’est plus estimé localement : seul le quota renvoyé par le serveur est affiché.
+
+## 1.4.0
+- Version initiale du CLI avec serveur API et Space Hugging Face.

opsiom_cli-1.5.0/PKG-INFO

@@ -0,0 +1,173 @@
+Metadata-Version: 2.5
+Name: opsiom-cli
+Version: 1.5.0
+Summary: Interface en ligne de commande pour discuter avec Opsiom, l'assistant IA francophone.
+Keywords: chatbot,cli,francophone,ia,opsiom
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Natural Language :: French
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Communications :: Chat
+Requires-Python: >=3.9
+Requires-Dist: requests>=2.31
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# opsiom-cli
+
+Discutez avec **Opsiom**, l’assistant IA francophone, depuis votre terminal.
+
+```
+pip install opsiom-cli
+opsiom
+```
+
+## Sommaire
+
+- [Démarrage rapide](#démarrage-rapide)
+- [Utilisation](#utilisation)
+- [Commandes de session](#commandes-de-session)
+- [Configuration](#configuration)
+- [Dépannage](#dépannage)
+- [Confidentialité et sécurité](#confidentialité-et-sécurité)
+- [Développement](#développement)
+
+## Démarrage rapide
+
+1. Installez le paquet (Python 3.9 ou plus récent) :
+
+   ```bash
+   pip install opsiom-cli
+   ```
+
+2. Lancez-le. Au premier démarrage, le CLI demande l’adresse du serveur, puis votre clé API ou votre pseudo Octix. Ces informations vous sont transmises par la personne qui héberge Opsiom.
+
+   ```bash
+   opsiom
+   ```
+
+3. Vérifiez la connexion à tout moment :
+
+   ```bash
+   opsiom doctor
+   ```
+
+## Utilisation
+
+| Commande | Effet |
+|---|---|
+| `opsiom` | Session interactive. |
+| `opsiom -p "Résume ce texte"` | Pose une question, affiche la réponse et quitte. |
+| `cat notes.txt \| opsiom` | Envoie le contenu de l’entrée standard comme question. |
+| `opsiom -m <modèle> …` | Choisit le modèle (identifiant ou nom partiel). |
+| `opsiom configure` | Reconfigure le serveur et la clé d’accès. |
+| `opsiom doctor` | Vérifie l’URL, le serveur, les modèles et le quota. |
+| `opsiom paths` | Affiche les emplacements des fichiers locaux. |
+| `opsiom --logo` | Affiche le repère graphique au démarrage de la session. |
+
+### Saisie multiligne
+
+Dans une session, tapez `"""` seul sur une ligne, écrivez votre texte, puis terminez par `"""` seul sur une ligne. Entrée seule envoie un message simple.
+
+## Commandes de session
+
+| Commande | Effet |
+|---|---|
+| `/retry` | Relance la dernière question. |
+| `/copy` | Copie la dernière réponse dans le presse-papiers. |
+| `/save [nom]` | Exporte la conversation en Markdown dans `~/opsiom-conversations/`. |
+| `/new` | Repart d’une conversation vide. |
+| `/clear` | Efface l’écran. |
+| `/model [id ou numéro]` | Change de modèle. Sans argument, affiche un menu. |
+| `/models` | Liste les modèles disponibles. |
+| `/status` | Rappelle la connexion, le compte et le quota. |
+| `/quota` | Affiche le quota restant aujourd’hui. |
+| `/doctor` | Lance le diagnostic depuis la session. |
+| `/help` | Affiche l’aide. |
+| `/quit` | Quitte (aussi `/exit`, ou Ctrl+D). |
+
+Raccourcis : **Entrée** envoie, **Ctrl+C** annule la saisie ou la réponse en cours, **Ctrl+D** quitte. L’historique des saisies se parcourt avec les flèches.
+
+## Configuration
+
+Les paramètres sont lus dans cet ordre de priorité : options de ligne de commande, variables d’environnement, fichier de configuration.
+
+| Option | Variable d’environnement | Rôle |
+|---|---|---|
+| `--url` | `OPSIOM_URL` | Adresse du serveur ou du Space Hugging Face. |
+| `--api-key` | `OPSIOM_API_KEY` | Clé API (serveur API). |
+| `--backend` | `OPSIOM_BACKEND` | `api`, `hf` ou `auto` (d’après l’adresse). |
+| `--username` | `OPSIOM_USERNAME` | Pseudo Octix (Space Hugging Face). |
+| — | `OPSIOM_PASSWORD` | Mot de passe Octix. **Déconseillé** : visible par les autres processus du même utilisateur. Préférez la saisie masquée. |
+| `--hf-token` | `OPSIOM_HF_TOKEN` ou `HF_TOKEN` | Jeton Hugging Face, si le Space est privé. |
+
+Fichiers locaux (`opsiom paths` les affiche) :
+
+- **configuration** : `config.json`, droits 600. Le mot de passe n’y est jamais écrit.
+- **quota local** : `usage.json`, un cache d’affichage. Le serveur fait foi.
+- **historique de saisie** : pour la flèche du haut.
+- **transcriptions** : dossier des exports `/save`.
+
+### Affichage
+
+- Les couleurs sont désactivées si `NO_COLOR` est défini, si `TERM=dumb`, ou si la sortie est redirigée vers un fichier ou un pipe.
+- Sur un terminal sans UTF-8, les symboles basculent sur de l’ASCII.
+
+## Dépannage
+
+**« connexion impossible »**
+Vérifiez l’adresse avec `opsiom doctor`, puis votre réseau. Si le serveur est un Space Hugging Face, il peut être en veille : patientez une minute, puis relancez.
+
+**« clé API invalide ou expirée »**
+Reconfigurez avec `opsiom configure`.
+
+**« session expirée ou refusée par le Space »**
+Le CLI propose de vous reconnecter, puis renvoie votre message.
+
+**« quota quotidien atteint » ou « quota dépassé côté serveur »**
+Le quota se réinitialise chaque jour. Utilisez `/quota` pour voir où vous en êtes.
+
+**« modèle inconnu » ou « hors forfait »**
+Tapez `/models` pour la liste. Un modèle marqué « hors forfait » n’est pas inclus dans votre offre.
+
+**Les accents ou les couleurs s’affichent mal**
+Utilisez un terminal qui gère l’UTF-8 et les couleurs 256. Sous Windows, préférez Windows Terminal.
+
+**Le presse-papiers ne fonctionne pas avec `/copy`**
+Sous Linux, installez `xclip`, `wl-copy` ou `xsel`. Sous macOS et Windows, les outils système sont utilisés.
+
+## Confidentialité et sécurité
+
+- Chaque message est envoyé au serveur d’Opsiom. Le CLI ne transmet rien d’autre.
+- Le mot de passe Octix n’est jamais enregistré : il est demandé à chaque lancement (saisie masquée).
+- La clé API est stockée dans `config.json`, avec des droits 600. Ne partagez pas ce fichier.
+- Un serveur `http://` distant est signalé : la clé et le mot de passe circuleraient en clair. Utilisez `https://`.
+- Le contenu des conversations n’est écrit sur le disque que si vous lancez `/save`.
+
+## Développement
+
+```bash
+git clone <dépôt>
+cd opsiom-cli
+pip install -e ".[dev]"
+pytest
+```
+
+Structure :
+
+```
+src/opsiom_cli/
+├── cli.py       options, configuration, question unique, sous-commandes
+├── chat.py      session interactive, commandes, diagnostic, erreurs
+├── clients.py   clients serveur API et Space Hugging Face, flux SSE
+├── storage.py   chemins, configuration, quota local, transcriptions
+└── ui.py        couleurs, symboles, indicateur d’attente, streaming
+tests/           tests unitaires et tests de bout en bout (faux serveur)
+```
+
+## Licence
+
+À compléter.

opsiom_cli-1.5.0/README.md

@@ -0,0 +1,155 @@
+# opsiom-cli
+
+Discutez avec **Opsiom**, l’assistant IA francophone, depuis votre terminal.
+
+```
+pip install opsiom-cli
+opsiom
+```
+
+## Sommaire
+
+- [Démarrage rapide](#démarrage-rapide)
+- [Utilisation](#utilisation)
+- [Commandes de session](#commandes-de-session)
+- [Configuration](#configuration)
+- [Dépannage](#dépannage)
+- [Confidentialité et sécurité](#confidentialité-et-sécurité)
+- [Développement](#développement)
+
+## Démarrage rapide
+
+1. Installez le paquet (Python 3.9 ou plus récent) :
+
+   ```bash
+   pip install opsiom-cli
+   ```
+
+2. Lancez-le. Au premier démarrage, le CLI demande l’adresse du serveur, puis votre clé API ou votre pseudo Octix. Ces informations vous sont transmises par la personne qui héberge Opsiom.
+
+   ```bash
+   opsiom
+   ```
+
+3. Vérifiez la connexion à tout moment :
+
+   ```bash
+   opsiom doctor
+   ```
+
+## Utilisation
+
+| Commande | Effet |
+|---|---|
+| `opsiom` | Session interactive. |
+| `opsiom -p "Résume ce texte"` | Pose une question, affiche la réponse et quitte. |
+| `cat notes.txt \| opsiom` | Envoie le contenu de l’entrée standard comme question. |
+| `opsiom -m <modèle> …` | Choisit le modèle (identifiant ou nom partiel). |
+| `opsiom configure` | Reconfigure le serveur et la clé d’accès. |
+| `opsiom doctor` | Vérifie l’URL, le serveur, les modèles et le quota. |
+| `opsiom paths` | Affiche les emplacements des fichiers locaux. |
+| `opsiom --logo` | Affiche le repère graphique au démarrage de la session. |
+
+### Saisie multiligne
+
+Dans une session, tapez `"""` seul sur une ligne, écrivez votre texte, puis terminez par `"""` seul sur une ligne. Entrée seule envoie un message simple.
+
+## Commandes de session
+
+| Commande | Effet |
+|---|---|
+| `/retry` | Relance la dernière question. |
+| `/copy` | Copie la dernière réponse dans le presse-papiers. |
+| `/save [nom]` | Exporte la conversation en Markdown dans `~/opsiom-conversations/`. |
+| `/new` | Repart d’une conversation vide. |
+| `/clear` | Efface l’écran. |
+| `/model [id ou numéro]` | Change de modèle. Sans argument, affiche un menu. |
+| `/models` | Liste les modèles disponibles. |
+| `/status` | Rappelle la connexion, le compte et le quota. |
+| `/quota` | Affiche le quota restant aujourd’hui. |
+| `/doctor` | Lance le diagnostic depuis la session. |
+| `/help` | Affiche l’aide. |
+| `/quit` | Quitte (aussi `/exit`, ou Ctrl+D). |
+
+Raccourcis : **Entrée** envoie, **Ctrl+C** annule la saisie ou la réponse en cours, **Ctrl+D** quitte. L’historique des saisies se parcourt avec les flèches.
+
+## Configuration
+
+Les paramètres sont lus dans cet ordre de priorité : options de ligne de commande, variables d’environnement, fichier de configuration.
+
+| Option | Variable d’environnement | Rôle |
+|---|---|---|
+| `--url` | `OPSIOM_URL` | Adresse du serveur ou du Space Hugging Face. |
+| `--api-key` | `OPSIOM_API_KEY` | Clé API (serveur API). |
+| `--backend` | `OPSIOM_BACKEND` | `api`, `hf` ou `auto` (d’après l’adresse). |
+| `--username` | `OPSIOM_USERNAME` | Pseudo Octix (Space Hugging Face). |
+| — | `OPSIOM_PASSWORD` | Mot de passe Octix. **Déconseillé** : visible par les autres processus du même utilisateur. Préférez la saisie masquée. |
+| `--hf-token` | `OPSIOM_HF_TOKEN` ou `HF_TOKEN` | Jeton Hugging Face, si le Space est privé. |
+
+Fichiers locaux (`opsiom paths` les affiche) :
+
+- **configuration** : `config.json`, droits 600. Le mot de passe n’y est jamais écrit.
+- **quota local** : `usage.json`, un cache d’affichage. Le serveur fait foi.
+- **historique de saisie** : pour la flèche du haut.
+- **transcriptions** : dossier des exports `/save`.
+
+### Affichage
+
+- Les couleurs sont désactivées si `NO_COLOR` est défini, si `TERM=dumb`, ou si la sortie est redirigée vers un fichier ou un pipe.
+- Sur un terminal sans UTF-8, les symboles basculent sur de l’ASCII.
+
+## Dépannage
+
+**« connexion impossible »**
+Vérifiez l’adresse avec `opsiom doctor`, puis votre réseau. Si le serveur est un Space Hugging Face, il peut être en veille : patientez une minute, puis relancez.
+
+**« clé API invalide ou expirée »**
+Reconfigurez avec `opsiom configure`.
+
+**« session expirée ou refusée par le Space »**
+Le CLI propose de vous reconnecter, puis renvoie votre message.
+
+**« quota quotidien atteint » ou « quota dépassé côté serveur »**
+Le quota se réinitialise chaque jour. Utilisez `/quota` pour voir où vous en êtes.
+
+**« modèle inconnu » ou « hors forfait »**
+Tapez `/models` pour la liste. Un modèle marqué « hors forfait » n’est pas inclus dans votre offre.
+
+**Les accents ou les couleurs s’affichent mal**
+Utilisez un terminal qui gère l’UTF-8 et les couleurs 256. Sous Windows, préférez Windows Terminal.
+
+**Le presse-papiers ne fonctionne pas avec `/copy`**
+Sous Linux, installez `xclip`, `wl-copy` ou `xsel`. Sous macOS et Windows, les outils système sont utilisés.
+
+## Confidentialité et sécurité
+
+- Chaque message est envoyé au serveur d’Opsiom. Le CLI ne transmet rien d’autre.
+- Le mot de passe Octix n’est jamais enregistré : il est demandé à chaque lancement (saisie masquée).
+- La clé API est stockée dans `config.json`, avec des droits 600. Ne partagez pas ce fichier.
+- Un serveur `http://` distant est signalé : la clé et le mot de passe circuleraient en clair. Utilisez `https://`.
+- Le contenu des conversations n’est écrit sur le disque que si vous lancez `/save`.
+
+## Développement
+
+```bash
+git clone <dépôt>
+cd opsiom-cli
+pip install -e ".[dev]"
+pytest
+```
+
+Structure :
+
+```
+src/opsiom_cli/
+├── cli.py       options, configuration, question unique, sous-commandes
+├── chat.py      session interactive, commandes, diagnostic, erreurs
+├── clients.py   clients serveur API et Space Hugging Face, flux SSE
+├── storage.py   chemins, configuration, quota local, transcriptions
+└── ui.py        couleurs, symboles, indicateur d’attente, streaming
+tests/           tests unitaires et tests de bout en bout (faux serveur)
+```
+
+## Licence
+
+À compléter.

opsiom_cli-1.5.0/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["hatchling>=1.18"]
+build-backend = "hatchling.build"
+
+[project]
+name = "opsiom-cli"
+version = "1.5.0"
+description = "Interface en ligne de commande pour discuter avec Opsiom, l'assistant IA francophone."
+readme = "README.md"
+requires-python = ">=3.9"
+# TODO : compléter la licence et les auteurs avant publication
+# license = { text = "..." }
+# authors = [{ name = "..." }]
+keywords = ["opsiom", "ia", "chatbot", "cli", "francophone"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "Natural Language :: French",
+    "Operating System :: OS Independent",
+    "Topic :: Communications :: Chat",
+]
+dependencies = [
+    "requests>=2.31",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=7"]
+
+[project.scripts]
+opsiom = "opsiom_cli.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/opsiom_cli"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]

opsiom_cli-1.5.0/src/opsiom_cli/__init__.py

@@ -0,0 +1,8 @@
+"""Client en ligne de commande pour Opsiom."""
+
+from importlib.metadata import PackageNotFoundError, version as _pkg_version
+
+try:
+    __version__ = _pkg_version("opsiom-cli")
+except PackageNotFoundError:  # exécution depuis les sources, sans installation
+    __version__ = "0.0.0+dev"

opsiom_cli-1.5.0/src/opsiom_cli/__main__.py

@@ -0,0 +1,6 @@
+"""Permet `python -m opsiom_cli`."""
+
+from .cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())