Publicado el
API

Un Tutorial Paso a Paso para Instalar y Usar la Herramienta de Codificación con IA aider

Imagen del post aider.chat es una herramienta de código abierto diseñada para programación en pareja con LLMs, permitiéndote editar código en tu repositorio local de Git. Aider funciona mejor con GPT-4o y Claude-3.5 Sonnet y puede conectarse a casi cualquier LLM. Este tutorial te guía a través del proceso de instalar aider y usarlo en un escenario práctico para mejorar tu productividad.

Requisitos Previos

Antes de comenzar, asegúrate de tener lo siguiente:

  • Sistema Operativo: Linux (preferido).
  • Python: Python 3.8 o superior instalado en tu sistema.
  • Acceso a la Terminal: Familiaridad básica con el uso de la terminal/línea de comandos.

Nota del Entorno: Este tutorial se realizó en una configuración de Ubuntu WSL (Windows Subsystem for Linux) ejecutándose en una computadora personal con Windows 11. Los pasos deberían ser similares para otros entornos basados en Linux.

Paso 1: Instalación de aider.chat usando pipx

Para instalar aider.chat, se recomienda usar pipx, que te permite instalar y ejecutar aplicaciones de Python en entornos aislados. Esto evita conflictos de dependencias entre diferentes proyectos de Python en tu sistema. Sigue las instrucciones en la página de instalación de pipx de aider.chat.

Para instalar aider.chat usando pipx:

  1. Instala pipx (si no está instalado).

  2. Instala aider.chat con pipx.

Después de la instalación, puedes ejecutar aider.chat directamente desde la línea de comandos.

Paso 2: Integración de aider.chat con un Modelo LLM

En este paso, integraremos aider.chat con el modelo LLM Anthropic Claude-3.5-Sonnet usando el proveedor OpenRouter.

Para obtener más información sobre el modelo y el proveedor, puedes consultar los siguientes enlaces:

Configuración de la Integración

  1. Obtén las Claves API: Regístrate y obtén tu clave API de OpenRouter.

Paso 3: Ejecución de la Herramienta aider desde la Línea de Comandos

En este paso, navegaremos al directorio raíz de un repositorio Git que contiene un proyecto Python y ejecutaremos la herramienta aider desde la línea de comandos. Para este tutorial, he usado un proyecto personal de Python que incluye varias herramientas de Python utilizadas para trabajar en mi blog.

  1. Navega al Repositorio Git: Muévete al directorio raíz de tu proyecto.

  2. Configura la Variable de Entorno: Asegúrate de que la variable de entorno OPENROUTER_API_KEY esté configurada con tu clave API.

  3. Ejecuta aider con el Modelo LLM: Usa la línea de comandos para iniciar aider con el modelo Claude-3.5-Sonnet a través de OpenRouter:

    aider --model openrouter/anthropic/claude-3.5-sonnet
    
    Ejecución de la herramienta aider

Paso 4: Agregar un Archivo Python al Chat

Para los siguientes casos prácticos, usaremos una herramienta simple de Python en mi proyecto. Esta herramienta automatiza la traducción de publicaciones de blog de inglés a otros idiomas usando agentes de Camel AI integrados con proveedores de API LLM.

  1. Agrega un Archivo Python: Agrega un archivo Python a la sesión de chat de aider para colaboración interactiva con este comando de aider.

    /add CAMEL_translate_tool_mistral.py
    
    Agregar archivo al chat

Y básicamente, estás listo para comenzar con estos casos prácticos para mostrar las capacidades de aider como tu asistente de codificación con IA.

Caso Práctico 1: Agregar docstrings a Métodos de Python

  1. Instruye a aider para agregar docstrings: Usa aider para generar documentación detallada de docstrings para los métodos en tu script de Python.

    Agregar Docstrings Figura 1
    Agregar Docstrings Figura 2

Resultados: Los resultados fueron positivos. Aider agregó docstrings claros y precisos, mejorando la legibilidad y mantenibilidad del script.

Tokens de API LLM Usados y Costo: Estos se muestran en la imagen anterior.

Caso Práctico 2: Agregar Soporte para GROQ modelfactory

Ahora una tarea más difícil. Mi script está integrado con dos proveedores de API LLM: Mistral y Gemini. En este caso, instruimos a aider para agregar soporte para el proveedor GROQ, usando para inferencia el modelo Groq Llama 3 8B. Aider actualizó el script para incluir las importaciones necesarias, la inicialización del modelo y los ajustes para la compatibilidad.

Agregar Soporte GROQ Figura 1
Agregar Soporte GROQ Figura 2
Agregar Soporte GROQ Figura 3

Resultados

Aunque la integración fue mayormente exitosa, se identificaron dos problemas:

  1. Configuración Incorrecta del Modelo: Aider configuró inicialmente el modelo de manera incorrecta.
  2. URL Incorrecta de la API GROQ: Aider no configuró la URL correcta para la API GROQ, lo que resultó en problemas de integración.

Instruí a aider para configurar la URL de la API, pero los resultados no fueron satisfactorios. En consecuencia, revertí los cambios usando el comando /undo de aider.

Problema de Configuración del Modelo Figura

Finalmente, actualicé manualmente el script para asegurarme de que tanto la configuración del modelo como la URL de la API estuvieran correctamente configuradas.

Edición Manual para la URL Figura

Después de abordar estos problemas manualmente, las pruebas confirmaron que el modelo y la API se integraron y funcionaron como se esperaba.

Caso Práctico 3: Modificación del Método de Commit para Creación de Ramas

  1. Actualiza el Método de Commit: Instruye a aider para modificar la lógica de commit en mi script para crear la rama objetivo si no existe.

    Agregar Soporte GROQ Figura 4

Resultados: La rama objetivo se creó con éxito cuando no existía, y los cambios se confirmaron sin problemas, confirmando las capacidades de aider.

Conclusiones

  • Fácil de Usar: Los pasos para instalar y usar aider.chat son simples y directos, haciéndolo accesible para cualquiera con experiencia básica en la línea de comandos.
  • Resultados Positivos: En general, la herramienta proporcionó resultados positivos, logrando efectivamente las modificaciones que buscábamos.
  • Caso de Uso Básico: Este tutorial demostró un caso de uso básico, modificando solo un script de Python. Se pueden explorar casos de uso más complejos en futuras publicaciones.
  • Integración con Git: La integración perfecta de aider.chat con Git facilitó el control de versiones y la gestión de ramas, asegurando un seguimiento eficiente de los cambios.
  • Consideraciones de Costo: Al usar la API LLM, es importante tener en cuenta los costos asociados, especialmente para usos extensivos o de nivel de producción.

Enlaces

Consulta Otros Tutoriales en Mi Blog

Si encontraste útil este tutorial, también podrías disfrutar de estos:


¿Disfrutaste esta publicación? ¿Te resultó útil? Siéntete libre de dejar un comentario a continuación para compartir tus pensamientos o hacer preguntas. Se requiere una cuenta de GitHub para unirse a la discusión.

Sigue leyendo

Posts relacionados