django-lucy-assist 1.3.4

Assistant IA intelligent Revolucy pour outil métier

Django Lucy Assist

Assistant IA intelligent base sur Claude (Anthropic), integrable dans n'importe quelle application Django.

Installation

pip install django-lucy-assist

Configuration

1. Ajouter l'application a INSTALLED_APPS

INSTALLED_APPS = [
    ...
    'lucy_assist',
]

2. Configurer les variables d'environnement

Ajouter dans votre fichier .env :

# ======================================== LUCY ASSIST ========================================
ANTHROPIC_LUCY_API_KEY=votre-cle-api-anthropic
GITLAB_URL=https://gitlab.com
GITLAB_TOKEN=glpat-... # Création d'un jeton d'accès en role Reporter avec les accès read_api, read_repository
GITLAB_PROJECT_ID=123

# SIREN client pour l'API Lucy CRM  (Si non present via le module de retour)
SIREN_CLIENT=123456789

Puis dans votre settings.py :

import os

#############################################################################################################
# Lucy Assist
ANTHROPIC_LUCY_API_KEY = env('ANTHROPIC_LUCY_API_KEY', default=None)
GITLAB_URL = env('GITLAB_URL', default=None)
GITLAB_TOKEN = env('GITLAB_TOKEN', default=None)
GITLAB_PROJECT_ID = env('GITLAB_PROJECT_ID', default=None)
LUCY_ASSIST = {'PROJECT_APPS_PREFIX': 'apps.'}

3. Ajouter les URLs

# urls.py
from django.urls import path, include

urlpatterns = [
    ...
    path('lucy-assist/', include('lucy_assist.urls')),
]

4. Ajouter le context processor

# settings.py
TEMPLATES = [
    {
        ...
        'OPTIONS': {
            'context_processors': [
                ...
                'lucy_assist.context_processors.lucy_assist_context',
            ],
        },
    },
]

5. Inclure le template dans votre base.html

<!-- templates/base.html -->
{% include 'lucy_assist/chatbot_sidebar.html' %}

6. Executer les migrations

python manage.py migrate lucy_assist

Utilisation

Une fois installe et configure, Lucy Assist apparaitra automatiquement sur toutes les pages de votre application avec un bouton flottant en bas a droite.

Fonctionnalites

• Chat IA contextuel : Lucy comprend le contexte de la page actuelle
• Actions CRUD : Lucy peut creer, modifier, rechercher et supprimer des objets
• Analyse de bugs : Connexion a GitLab pour analyser les problemes signales
• Historique des conversations : Sauvegarde automatique des conversations
• Gestion des tokens : Suivi de la consommation des tokens Claude

Configuration avancee

Modele de base personnalise

Si vous utilisez un modele de base personnalise avec des champs d'audit (created_date, updated_date, etc.), vous pouvez le configurer :

LUCY_ASSIST = {
    'BASE_MODEL': 'mon_app.models.MonModeleBase',
}

Modele Claude

Par defaut, Lucy Assist utilise claude-sonnet-4-20250514. Vous pouvez changer le modele :

LUCY_ASSIST = {
    'CLAUDE_MODEL': 'claude-sonnet-4-20250514',  # Ou 'claude-haiku-4-5-20251001', etc.
}

Personnalisation des questions frequentes

LUCY_ASSIST = {
    'QUESTIONS_FREQUENTES_DEFAULT': [
        "Comment creer un nouveau membre ?",
        "Comment effectuer un paiement ?",
        "Comment exporter des donnees ?",
    ],
}

API

Lucy Assist expose plusieurs endpoints API :

• GET /lucy-assist/api/conversations/ - Liste des conversations
• POST /lucy-assist/api/conversations/ - Creer une conversation
• GET /lucy-assist/api/conversations/<id>/ - Detail d'une conversation
• POST /lucy-assist/api/conversations/<id>/messages/ - Ajouter un message
• POST /lucy-assist/api/conversations/<id>/completion/ - Generer une reponse (streaming)
• GET /lucy-assist/api/tokens/status/ - Statut des tokens

Licence

Revolucy

Lancer le serveur de test

python test_project/manage.py runserver

Ensuite, accède à :

• Page de test : http://localhost:8000/
• Module retour client : http://localhost:8000/retour/
• Admin Django : http://localhost:8000/admin/
• Lancement des tests sur les questions : python manage.py test_lucy

Deploiement Pypi

1. docker-compose exec django pip install build twine
2. docker-compose exec django python -m build
3. python -m twine upload dist/*
4. Indiquer le token present dans 1Password