Metadata-Version: 2.4
Name: django-ai-validator
Version: 0.1.1
Summary: A Django library for AI-powered data validation and cleaning.
Project-URL: Homepage, https://github.com/mazafard/django-ai-validator
Author-email: mazafard <each_scow_6j@icloud.com>
License-Expression: MIT
License-File: LICENSE
Requires-Python: >=3.10
Requires-Dist: celery>=5.3.0
Requires-Dist: django>=4.2
Requires-Dist: google-generativeai>=0.3.0
Requires-Dist: ollama>=0.1.0
Requires-Dist: openai>=1.0.0
Description-Content-Type: text/markdown

# Django AI Validator

A Django library for AI-powered data validation and cleaning.

## Features

- **Semantic Validation**: Validate data based on meaning using LLMs.
- **Automated Cleaning**: Automatically clean and normalize data.
- **Admin Integration**: Bulk actions and status indicators in Django Admin.
- **Asynchronous Support**: Offload LLM calls to Celery tasks.
- **Multiple Providers**: Support for OpenAI, Anthropic, Gemini, and Ollama.

## Installation

```bash
pip install django-ai-validator
```

## Configuration

Add to `INSTALLED_APPS`:

```python
INSTALLED_APPS = [
    ...
    'django_ai_validator',
]
```

Set your API key:

```python
# Defaults to OpenAIClient
AI_CLEANER_LLM_CLIENT = 'django_ai_validator.llm.client.OpenAIClient'
OPENAI_API_KEY = "your-api-key"
```

## Usage

### Semantic Validation

```python
from django.db import models
from django_ai_validator.validators import AISemanticValidator

class Product(models.Model):
    description = models.TextField(
        validators=[
            AISemanticValidator(
                prompt_template="Ensure the description is marketing-friendly and contains no offensive language."
            )
        ]
    )
```

### Automatic Cleaning

```python
from django_ai_validator.fields import AICleanedField

class UserProfile(models.Model):
    bio = AICleanedField(
        cleaning_prompt="Fix grammar and remove personal contact info."
    )
```

### Admin Integration

```python
from django.contrib import admin
from django_ai_validator.admin import AIAdminMixin
from .models import MyModel

@admin.register(MyModel)
class MyModelAdmin(AIAdminMixin, admin.ModelAdmin):
    list_display = ['content', 'is_dirty']
    actions = ['run_ai_cleanup_on_selected']
```

### Manual Validation

To check if user input contains bad words:

```python
from django_ai_validator.validators import AISemanticValidator

class Comment(models.Model):
    text = models.TextField(
        validators=[
            AISemanticValidator(
                prompt_template="Check if this text contains bad words. Return VALID if not."
            )
        ]
    )
```

### Asynchronous Cleaning

To automatically remove personal information:

```python
from django_ai_validator.fields import AICleanedField

class Feedback(models.Model):
    message = AICleanedField(
        cleaning_prompt="Remove PII.",
        use_async=True
    )
```
