{"id":48459,"date":"2025-03-07T09:00:11","date_gmt":"2025-03-07T08:00:11","guid":{"rendered":"https:\/\/www.hiberus.com\/crecemos-contigo\/?p=48459"},"modified":"2025-03-20T13:18:17","modified_gmt":"2025-03-20T12:18:17","slug":"construyendo-un-sistema-de-seguimiento-de-gastos-con-ia-usando-gradio-pydantic-ai-supabase-y-deepseek-una-guia-completa","status":"publish","type":"post","link":"https:\/\/www.hiberus.com\/crecemos-contigo\/construyendo-un-sistema-de-seguimiento-de-gastos-con-ia-usando-gradio-pydantic-ai-supabase-y-deepseek-una-guia-completa\/","title":{"rendered":"C\u00f3mo construir un sistema de seguimiento de gastos con IA"},"content":{"rendered":"

\u00bfAlguna vez te has preguntado c\u00f3mo aprovechar la IA para rastrear tus gastos de manera sencilla? Soy Abbaoui Achraf, ingeniero de machine learning apasionado por las aplicaciones de IA.\u00a0 Acomp\u00e1\u00f1ame a construir una aplicaci\u00f3n de seguimiento de gastos impulsada por IA<\/strong> utilizando herramientas de vanguardia como DeepSeek<\/strong>, Gradio<\/strong>, Pydantic<\/strong>, Pydantic-AI<\/strong> y Supabase<\/strong>. Juntos, crearemos un sistema inteligente que no solo ayuda a las personas usuarias a gestionar sus gastos, sino que tambi\u00e9n proporciona insights inteligentes sobre sus patrones de gasto, todo mientras mantiene sus datos seguros en una base de datos de Supabase<\/strong>.<\/p>\n

\u00bfPor qu\u00e9 crear tu aplicaci\u00f3n de seguimiento de gastos con IA con Supabase?<\/h2>\n

Supabase<\/strong> ofrece una soluci\u00f3n backend como servicio (BaaS) que incluye bases de datos PostgreSQL en tiempo real, autenticaci\u00f3n y m\u00e1s. Es una excelente opci\u00f3n para este proyecto porque nos permite centrarnos en la l\u00f3gica de la aplicaci\u00f3n y el agente de IA, en lugar de preocuparnos por configurar y gestionar nuestra propia base de datos.<\/p>\n

\u00a1Comencemos!<\/p>\n

C\u00f3mo crear un seguimiento de gastos con IA paso a paso<\/h2>\n

1. Configuraci\u00f3n del Entorno<\/h3>\n

Primero, instala las bibliotecas necesarias para configurar el proyecto. Abre una terminal y ejecuta:<\/p>\n

pip install gradio pydantic pydantic-ai supabase logfire\r\n<\/code><\/pre>\n
Una vez instaladas las bibliotecas, podemos comenzar a configurar el entorno.<\/p>\n
<\/p>\n
2. Configuraci\u00f3n del Registro de Actividades (Logging)<\/h3>\n
Antes de sumergirnos en la aplicaci\u00f3n principal, es una buena pr\u00e1ctica configurar el registro de actividades para rastrear cualquier problema u operaci\u00f3n. Esto ayuda en la depuraci\u00f3n y mantenimiento de la aplicaci\u00f3n.<\/p>\n
import logfire\r\nlogfire.configure()\r\n<\/code><\/pre>\n
3. Definici\u00f3n de Modelos de Datos con Pydantic<\/h3>\n
<\/p>\n
Necesitamos definir los modelos de datos que representan la estructura de los gastos. Estos modelos aseguran que mantengamos datos consistentes y v\u00e1lidos en toda la aplicaci\u00f3n.<\/p>\n
Definici\u00f3n de Categor\u00edas de Gastos<\/h4>\n
Definimos las diferentes categor\u00edas de gastos, como comida<\/strong>, transporte<\/strong>, etc.<\/p>\n
from enum import Enum\r\n\r\nclass ExpenseCategory(str, Enum):\r\n    FOOD = \"comida\"\r\n    TRANSPORT = \"transporte\"\r\n    ENTERTAINMENT = \"entretenimiento\"\r\n    UTILITIES = \"servicios\"\r\n    RENT = \"alquiler\"\r\n    OTHER = \"otros\"\r\n<\/code><\/pre>\n
Creaci\u00f3n del Modelo Base de Gastos<\/h4>\n
Este es el modelo que representa una entrada de gasto individual:<\/p>\n
from pydantic import BaseModel, Field\r\nfrom datetime import date\r\nfrom uuid import UUID\r\n\r\nclass ExpenseBase(BaseModel):\r\n    uuid: UUID = Field(description='ID \u00fanico generado al crear un gasto')\r\n    title: str = Field(..., max_length=100)\r\n    date: date\r\n    description: str = Field(..., max_length=500)\r\n    category: ExpenseCategory\r\n    amount: float = Field(..., gt=0)\r\n<\/code><\/pre>\n
Creaci\u00f3n del Modelo de Respuesta<\/h4>\n
Este modelo estructurar\u00e1 la respuesta del agente de IA, incluyendo consejos para la persona usuaria y la lista de gastos:<\/p>\n
from typing import List, Tuple, Union\r\n\r\nclass ResultAnswer(BaseModel):\r\n    answer_to_user: str = Field(description='La respuesta que se debe devolver al usuario, debe ser clara, directa y en un tono amigable.')\r\n    expense: Union[List[ExpenseBase] | None]\r\n    tips_to_user: Tuple[bool, Union[str, None]]\r\n<\/code><\/pre>\n
4. Integraci\u00f3n de Pydantic-AI<\/h3>\n
Ahora que hemos definido nuestros modelos de datos, podemos crear nuestro agente de IA<\/strong> usando Pydantic-AI<\/strong>. Este agente ser\u00e1 responsable de interpretar las consultas del usuario, proporcionar respuestas e interactuar con la base de datos de Supabase<\/strong>.<\/p>\n
from pydantic_ai import Agent, RunContext\r\nfrom pydantic_ai.models.openai import OpenAIModel\r\nfrom pydantic_ai.usage import UsageLimits\r\nfrom supabase import Client\r\nfrom uuid import UUID\r\n\r\n@dataclass\r\nclass Dependencies:\r\n    user_uuid: UUID # Para este demo no lo usaremos\r\n    supabase: Client | None\r\n\r\nexpense_agent = Agent(\r\n    model=OpenAIModel(\r\n        'deepseek-chat',  # Usa el nombre de tu modelo aqu\u00ed\r\n        base_url='<https:\/\/api.deepseek.com\/v1>',\r\n        api_key='tu_api_key',  # Reemplaza con tu clave API real\r\n    ),\r\n    deps_type=Dependencies,\r\n    result_type=ResultAnswer,\r\n    system_prompt=(\r\n        'Eres un agente de IA especializado en el seguimiento de gastos, encargado de ayudar a los usuarios a gestionar sus finanzas personales de manera efectiva. '\r\n        'Tus funcionalidades incluyen registrar gastos, generar informes, enviar alertas de presupuesto y proporcionar insights basados en patrones de gasto.'\r\n    ),\r\n    model_settings={'temperature': 0.0} # Cuanto mayor sea la temperatura, m\u00e1s diversas pueden ser las respuestas del modelo\r\n)\r\n\r\n<\/code><\/pre>\n
5. Trabajando con Supabase<\/h2>\n
Supabase es una alternativa de c\u00f3digo abierto a Firebase y ofrece un conjunto completo de servicios backend, como autenticaci\u00f3n, almacenamiento y una potente base de datos PostgreSQL. Para este proyecto, usaremos principalmente la base de datos PostgreSQL<\/strong> de Supabase para almacenar, recuperar y actualizar los gastos de los usuarios.<\/p>\n
1. Configuraci\u00f3n del Cliente de Supabase<\/h3>\n
Para interactuar con Supabase, necesitas inicializar el cliente de Supabase<\/strong> en tu aplicaci\u00f3n. Esto nos permitir\u00e1 hacer consultas a la base de datos, como agregar o recuperar gastos.<\/p>\n
from supabase import create_client, Client\r\n\r\nurl = '<https:\/\/xyz.supabase.co>'  # Reemplaza con tu URL de Supabase\r\nkey = 'public-anon-key'  # Reemplaza con tu clave API de Supabase\r\n\r\nsupabase: Client = create_client(url, key)\r\n<\/code><\/pre>\n
2. Creaci\u00f3n de la Tabla de Gastos en Supabase<\/h3>\n
Antes de agregar o recuperar datos de Supabase, aseg\u00farate de haber creado una tabla para almacenar los gastos. Aqu\u00ed tienes un ejemplo de consulta SQL para crear la tabla expenses<\/code>:<\/p>\n
CREATE TABLE expenses (\r\n    uuid UUID PRIMARY KEY,\r\n    title TEXT NOT NULL,\r\n    date DATE NOT NULL,\r\n    description TEXT,\r\n    category TEXT NOT NULL,\r\n    amount FLOAT NOT NULL\r\n);\r\n<\/code><\/pre>\n
Puedes ejecutar esta consulta SQL en el Panel de Control de Supabase<\/strong> en la pesta\u00f1a \u00abSQL Editor\u00bb.<\/p>\n
6. Implementaci\u00f3n de Funciones de Interacci\u00f3n con la Base de Datos<\/h2>\n
Agregar Gastos a Supabase<\/h3>\n
Implementaremos una funci\u00f3n que insertar\u00e1 los datos de gastos en la base de datos de Supabase<\/strong>:<\/p>\n
@expense_agent.tool\r\nasync def add_to_database(ctx: RunContext[Dependencies], expenses: List[ExpenseBase]) -> str:\r\n    \"\"\"\r\n    Agrega gastos a la base de datos.\r\n    \"\"\"\r\n    try:\r\n        supabase: Client = ctx.deps.supabase_client\r\n        user_uuid: str = ctx.deps.user_uuid\r\n\r\n        rows_to_insert = []\r\n        for expense in expenses:\r\n            rows_to_insert.append({\r\n                \"user_uuid\": user_uuid,\r\n                \"title\": expense.title,\r\n                \"date\": expense.date.isoformat(),\r\n                \"description\": expense.description,\r\n                \"category\": expense.category.value,\r\n                \"amount\": expense.amount,\r\n            })\r\n\r\n        response = supabase.table(\"expenses\").insert(rows_to_insert).execute()\r\n\r\n        return f\"Tus gastos han sido guardados. Insertados: {json.dumps(response.data, indent=2)}\"\r\n    except Exception as e:\r\n        return f\"Error al agregar gastos a la base de datos. Error: {e}\"\r\n<\/code><\/pre>\n
Esta funci\u00f3n convierte el gasto en un diccionario, asegura que el UUID est\u00e9 correctamente formateado y luego inserta el gasto en la base de datos de Supabase<\/strong>.<\/p>\n
7. Recuperar Gastos de Supabase<\/h2>\n
Para recuperar una lista de gastos de la base de datos, implementamos una funci\u00f3n que consulta la tabla expenses<\/code>:<\/p>\n
@expense_agent.tool\r\nasync def retrive_from_database(ctx: RunContext[Dependencies]) -> str:\r\n    \"\"\"\r\n    Recupera todos los gastos del usuario actual de la base de datos.\r\n    \"\"\"\r\n    try:\r\n        supabase: Client = ctx.deps.supabase_client\r\n        user_uuid: str = ctx.deps.user_uuid\r\n\r\n        response = (\r\n            supabase\r\n            .table(\"expenses\")\r\n            .select(\"*\")\r\n            .eq(\"user_uuid\", user_uuid)\r\n            .order(\"created_at\", desc=True)  # o el orden que prefieras\r\n            .execute()\r\n        )\r\n\r\n        return json.dumps(response.data, indent=2)\r\n    except Exception as e:\r\n        return f\"Error al recuperar gastos de la base de datos. Error: {e}\"\r\n<\/code><\/pre>\n
Esta funci\u00f3n consulta todos los registros de la tabla expenses<\/code> y los devuelve como objetos ExpenseBase<\/code>.<\/p>\n
<\/p>\n
8. Actualizar Gastos en Supabase<\/h3>\n
Finalmente, agregaremos una funci\u00f3n para actualizar un gasto existente en la base de datos:<\/p>\n
@expense_agent.tool\r\nasync def update_from_database(ctx: RunContext[Dependencies], expense: ExpenseBase) -> str:\r\n    \"\"\"\r\n    Actualiza un gasto en la base de datos usando expense.uuid como clave primaria.\r\n    \"\"\"\r\n    try:\r\n        supabase: Client = ctx.deps.supabase_client\r\n\r\n        update_fields = {\r\n            \"title\": expense.title,\r\n            \"date\": expense.date.isoformat(),\r\n            \"description\": expense.description,\r\n            \"category\": expense.category.value,\r\n            \"amount\": expense.amount\r\n        }\r\n\r\n        # Usa expense.uuid para localizar el registro en la base de datos (asumiendo que \"expense_id\" es la PK)\r\n        response = (\r\n            supabase\r\n            .table(\"expenses\")\r\n            .update(update_fields)\r\n            .eq(\"expense_id\", str(expense.uuid))\r\n            .execute()\r\n        )\r\n\r\n        return f\"Gasto {expense.uuid} actualizado correctamente. Resultado: {json.dumps(response.data, indent=2)}\"\r\n\r\n    except Exception as e:\r\n        return f\"Error al actualizar el gasto en la base de datos. Error: {e}\"\r\n\r\n<\/code><\/pre>\n
Otras herramientas para ayudar al modelo a generar gastos<\/h4>\n
@expense_agent.tool\r\nasync def todays_date(ctx: RunContext[Dependencies]) -> str:\r\n    return str(date.today())\r\n\r\n@expense_agent.tool\r\nasync def generate_uuid(ctx: RunContext[Dependencies]) -> str:\r\n    return str(uuid.uuid4())\r\n<\/code><\/pre>\n
Prueba de la respuesta del agente<\/h4>\n
from IPython.display import Markdown, display\r\n\r\nr = expense_agent.run_sync(\r\n    'Compr\u00e9 10 caramelos, cada uno por 15dh, 2 botellas de agua por 5dh cada una y un s\u00e1ndwich por 20dh.',\r\n    deps=Dependencies(\r\n        user_uuid='cdb64645-e1e4-4686-af86-de8f581b8037',\r\n        supabase_client=None\r\n    ),\r\n    usage_limits=UsageLimits(request_limit=5),\r\n)\r\nprint(f\"Respuesta para el usuario:\\\\n>>{r.data.answer_to_user}\")\r\nprint(f\"Consejos para el usuario:\\\\n>>{r.data.tips_to_user[1] if r.data.tips_to_user[0] else 'Sin consejos'}\")\r\nprint(f\"Gasto registrado:\\\\n>>{r.data.expense}\")\r\n\r\n<\/code><\/pre>\n
Ejemplo de salida<\/h4>\n
Respuesta para el usuario:<\/p>\n
Tus gastos han sido registrados con \u00e9xito. Aqu\u00ed tienes un resumen de tus gastos recientes:<\/p>\n