Metadata-Version: 2.4
Name: doctum-agent
Version: 0.5.0
Summary: Agents de code spécialisés dans le terminal : un modèle LLM par agent, sur n'importe quel back-end.
Author: Yann Smatti
License-Expression: MIT
Project-URL: Homepage, https://github.com/doctum-consilium/doctum-code-agent
Project-URL: Repository, https://github.com/doctum-consilium/doctum-code-agent
Project-URL: Issues, https://github.com/doctum-consilium/doctum-code-agent/issues
Keywords: ai,agent,cli,tui,llm,coding-agent,ollama,litellm
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Utilities
Classifier: Natural Language :: French
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: litellm>=1.40.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: rich>=13.0.0
Requires-Dist: PyYAML>=6.0
Requires-Dist: textual>=1.0
Requires-Dist: cryptography>=42.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-cov>=5.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.24; extra == "dev"
Requires-Dist: ruff>=0.6; extra == "dev"
Dynamic: license-file

# doctum-agent — agent de code local, avec **tes** modèles

Un agent de code dans le terminal : un modèle par rôle (orchestrateur, codeur, relecteur…), sur
**n'importe quel back-end** que TU fournis. Tout tourne **en local** ; le code de ton projet ne
quitte pas ta machine. Édition **gratuite et open source** (MIT).

> Ce dépôt est **généré** depuis le socle privé de Doctum, débarrassé de toute pièce « maison »
> (routage mesuré, corpus cybersécurité, isolation durcie). Il ne contient que l'agent générique.

## Installer

```bash
# via npm (installe le paquet Python pour toi)
npm install -g @doctum/code-agent

# ou via uv / pipx / pip
uv tool install doctum-agent
pipx install doctum-agent
pip install --user doctum-agent
```

## Démarrer — tu apportes tes modèles (BYOK)

Trois voies, au choix :

- **Local, par défaut (aucune clé)** — lance [Ollama](https://ollama.com), tire un modèle, et c'est prêt :
  ```bash
  ollama pull qwen2.5-coder
  doctum "explique-moi ce dépôt"
  ```
- **Ton fournisseur** — mets ta clé dans l'environnement (ou `~/.doctum/config.yaml`) et repointe un rôle :
  ```bash
  export OPENAI_API_KEY=sk-...        # ou ANTHROPIC_API_KEY, etc.
  doctum "corrige le bug dans app.py"
  ```
- **Modèles gérés + cybersécurité** — l'édition **pro** de Doctum ajoute des modèles prêts à l'emploi,
  un routage mesuré, un corpus de sécurité et une exécution isolée :
  ```bash
  doctum connexion                    # essai puis abonnement
  ```

## Ce que fait l'agent

- Lit, écrit et édite des fichiers ; lance des commandes et des tests ; navigue le dépôt.
- Un **modèle par rôle**, configurable : l'orchestrateur délègue à un codeur, un relecteur, un
  explorateur… chacun sur le back-end que tu choisis.
- Serveurs **MCP** branchables (tes propres outils).
- Trois niveaux d'autorisation (`--mode read_only|workspace_write|full_access`) : par défaut, l'agent
  ne touche que ton projet et refuse le réseau.

```bash
doctum --show-config     # voir le routage des rôles → modèles
doctum --list-agents     # les rôles disponibles
doctum --help            # toutes les options
```

## Édition pro (Doctum)

L'édition gratuite est le socle. L'édition **pro** (`doctum connexion`) ajoute ce qui se mesure et se
maintient côté serveur : le routage **mesuré** modèle↔rôle, un corpus de **cybersécurité** interrogeable,
une **isolation durcie** de l'exécution, et des modèles gérés sans clé à fournir. Voir
[doctumconsilium.com](https://llm.doctumconsilium.com/offre).

## Licence

MIT — voir [LICENSE](LICENSE).
