Metadata-Version: 2.4
Name: trinitty
Version: 0.1.5
Summary: Personal voice assistant using OpenAI, g4f fallback providers, Google Cloud speech services, and local audio assets.
Author: on4r4p
Project-URL: Homepage, https://github.com/on4r4p/trinitty
Project-URL: Repository, https://github.com/on4r4p/trinitty
Project-URL: Issues, https://github.com/on4r4p/trinitty/issues
Keywords: voice-assistant,openai,g4f,speech-to-text,text-to-speech
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: g4f<7,>=6.6
Requires-Dist: openai<3,>=2.0
Requires-Dist: PyAudio>=0.2.13; platform_machine != "aarch64" and platform_machine != "armv7l" and platform_machine != "armv6l"
Requires-Dist: pvporcupine<4.0.0,>=3.0.0
Requires-Dist: webrtcvad-wheels>=2.0.14
Requires-Dist: requests>=2.31
Requires-Dist: sox>=1.5
Requires-Dist: spacy<4,>=3.7
Requires-Dist: detectlanguage>=2.0
Requires-Dist: deep-translator>=1.11
Requires-Dist: nltk>=3.8
Requires-Dist: urlextract>=1.9
Requires-Dist: beautifulsoup4>=4.12
Requires-Dist: PyGithub>=2.3
Requires-Dist: Unidecode>=1.3
Requires-Dist: googlesearch-python>=1.3
Requires-Dist: wikipedia>=1.4
Requires-Dist: google-cloud-texttospeech>=2.16
Requires-Dist: google-cloud-speech>=2.26
Requires-Dist: google-cloud-language>=2.13
Requires-Dist: google-cloud-translate>=3.15
Provides-Extra: browser-providers
Requires-Dist: platformdirs>=4.2; extra == "browser-providers"
Requires-Dist: selenium-wire>=5.1; extra == "browser-providers"
Requires-Dist: undetected-chromedriver>=3.5; extra == "browser-providers"
Provides-Extra: command-classifier
Requires-Dist: tensorflow; extra == "command-classifier"
Provides-Extra: dev
Requires-Dist: build>=1.2; extra == "dev"
Requires-Dist: ruff>=0.5; extra == "dev"
Requires-Dist: twine>=5.1; extra == "dev"

# Trinitty

Trinitty est un assistant vocal personnel pour Linux. Il utilise OpenAI en priorité pour répondre aux questions, puis bascule sur `gpt4free` si aucune clé OpenAI n'est configurée ou si l'appel OpenAI échoue.

Le projet combine reconnaissance vocale, synthèse vocale, commandes locales, historique de conversation, recherche web et fournisseurs LLM de secours.

## Fonctionnalités

- Assistant vocal avec mot-clé Porcupine ou mode push-to-talk si la clé Picovoice manque.
- Réponses LLM via l'API OpenAI avec clé dans `keys/openai.key` ou variable `OPENAI_API_KEY`.
- Fallback `gpt4free` avec filtrage automatique des providers utilisables pour une conversation texte.
- Synthèse vocale avec Google Cloud Text-to-Speech, puis fallback local optionnel `pico2wave`.
- Reconnaissance vocale avec Google Cloud Speech.
- Historique des questions/réponses par catégories, avec relecture audio des réponses connues.
- Commandes vocales locales: répéter la dernière réponse, afficher ou chercher dans l'historique, lire un fichier audio, lire un lien, attendre, quitter.
- Recherche Google/Wikipedia et lecture de liens web selon les commandes disponibles dans les fichiers `datas/*.trinity`.
- Déclencheurs et synonymes configurables via les fichiers CSV du dossier `datas/`.
- Sons locaux packagés dans `local_sounds/` pour les retours audio, erreurs, dates, providers, commandes et prompts.

## Installation depuis PyPI

```bash
pip install trinitty
```

Sur Debian/Ubuntu, Trinitty a aussi besoin de dépendances système pour l'audio, PyAudio, sox et les fallbacks locaux:

```bash
sudo apt-get install -y alsa-utils build-essential flac libasound2-dev libsox-fmt-all libttspico-utils portaudio19-dev python3-dev python3-venv sox
```

Lancer ensuite:

```bash
trinitty
```

Pour une installation dans un virtualenv comme `~/venvs/trinitty`, il est possible d'installer un lanceur utilisateur une seule fois:

```bash
~/venvs/trinitty/bin/trinitty --install-launcher
```

Le lanceur est créé dans `~/.local/bin/trinitty`. Il active automatiquement l'environnement propre nécessaire (`PYTHONNOUSERSITE=1`, `PYTHONPATH` vidé), ce qui permet ensuite de lancer simplement:

```bash
trinitty
```

## Installation depuis le dépôt

Depuis un checkout local, l'installateur crée ou réutilise un virtualenv, installe les dépendances Python, télécharge les données NLTK, installe le modèle spaCy français et peut installer les paquets système avec `--system`.

```bash
./install_dependencies.sh --system --venv
```

Si `.venv` n'est pas inscriptible, le script utilise automatiquement `.venv-trinitty`. L'installateur crée aussi un lanceur `~/.local/bin/trinitty`, afin de lancer Trinitty sans activer le virtualenv à la main.

Options utiles:

```bash
./install_dependencies.sh --no-spacy-model
./install_dependencies.sh --no-nltk-data
./install_dependencies.sh --no-dev-tools
./install_dependencies.sh --no-launcher
./install_dependencies.sh --venv-dir .venv-trinitty
```

## Configuration OpenAI

Le plus simple est de créer un fichier contenant uniquement la clé API:

```bash
mkdir -p keys
printf '%s\n' 'sk-...' > keys/openai.key
```

Ne pas mettre de guillemets autour de la clé. Les lignes vides et les commentaires commençant par `#` sont ignorés.

Pour une installation PyPI, Trinitty vérifie aussi:

```bash
~/.local/share/Trinitty/keys/openai.key
```

Il est également possible d'utiliser une variable d'environnement:

```bash
export OPENAI_API_KEY='sk-...'
```

Au premier lancement depuis une installation PyPI, Trinitty prépare automatiquement le dossier utilisateur:

```bash
~/.local/share/Trinitty/
```

Les fichiers les plus utiles y sont créés sans écraser l'existant:

- `datas/conf.trinity`: overrides locaux lus après la configuration fournie avec le package.
- `keys/openai.key`: clé OpenAI, une seule ligne, sans guillemets.
- `keys/README.txt`: rappel des fichiers de clés reconnus.
- `history/`, `tmp/`, `saved_answer/`, `g4f_cookies/`: dossiers runtime.

La configuration par défaut fournie avec le package est dans `datas/conf.trinity`. Pour éviter de publier des chemins ou préférences locales, placer les overrides dans `~/.local/share/Trinitty/datas/conf.trinity`.

Exemple:

```text
SAVED_ANSWER = default
OPENAI_API_KEY_FILE = keys/openai.key
OPENAI_MODEL = gpt-5.5
OPENAI_TIMEOUT = 30
GPT4FREE_SERVERS_STATUS = Active
```


## gpt4free

Au démarrage, Trinitty peut vérifier les providers `gpt4free` disponibles et garder seulement ceux qui sont marqués comme fonctionnels et compatibles avec une réponse texte.

OpenAI reste le chemin principal. `gpt4free` sert de secours:

- si aucune clé OpenAI n'est disponible;
- si OpenAI renvoie une erreur;
- si OpenAI est désactivé avec `OPENAI_ENABLED = False`.

Certains providers nécessitent des cookies ou des jetons. Les captures locales peuvent être placées dans `tools/har_and_cookies/`

## Fichiers de configuration

Les fichiers principaux sont:

- `datas/conf.trinity`: configuration par défaut.
- `datas/cmd.trinity`: commandes principales.
- `datas/alt_cmd.trinity`: variantes de commandes.
- `datas/alt_trigger.trinity`: variantes de déclencheurs.
- `datas/action.trinity`: verbes/actions reliés aux fonctions.
- `datas/synonym.trinity`: synonymes utilisés par l'analyse.
- `datas/prefix.trinity`: préfixes de commandes.

## Historique et fichiers runtime

Trinitty écrit les réponses audio sauvegardées, l'historique, les erreurs et les fichiers temporaires dans des dossiers.

Dans un checkout local, les chemins par défaut restent proches du dépôt. En installation PyPI ou si le dossier installé n'est pas inscriptible, Trinitty bascule vers:

```bash
~/.local/share/Trinitty/
```

Cela évite d'écrire dans le dossier du package installé.

## Build local

L'installateur installe les outils de packaging par défaut. Après activation du virtualenv:

```bash
python -m build
python -m twine check --strict dist/*
```

Sans virtualenv:

```bash
python -m pip install --upgrade build twine
python -m build
```
