Saltar al contenido principal
Aider es una herramienta de programación en pareja con IA que edita tu repositorio git local desde la terminal. Venice funciona con el soporte de API compatible con OpenAI de Aider: establece la URL base y la API key de Venice, y luego antepón openai/ al ID del modelo.

Programación en pareja en la terminal

Edita tu repositorio git con modelos de Venice desde la CLI

Compatible con OpenAI

Usa el endpoint /chat/completions de Venice

Cualquier modelo de texto

Intercambia por cualquier ID de modelo de texto de Venice

​
Requisitos previos

  • Una API key de Venice desde venice.ai/settings/api
  • Python 3.9+ disponible en tu máquina
  • Un repositorio git donde trabajar

​
Configuración

1

Instala Aider

Instala Aider con el instalador oficial:
Consulta la documentación de instalación de Aider si prefieres otro método de instalación.
2

Configura Venice como el endpoint de OpenAI

Apunta Aider a Venice estableciendo la URL base compatible con OpenAI y tu API key de Venice.Mac / Linux:
Windows (PowerShell):
Windows (Símbolo del sistema, persistente):
Reinicia la terminal después de setx para que las nuevas variables estén disponibles.
3

Inicia Aider con un modelo de Venice

Desde el directorio de tu proyecto, antepón openai/ al ID del modelo de Venice:
Otros buenos modelos para empezar:
Explora todos los IDs de modelos de texto en el catálogo de modelos.

​
Persistir la configuración con .env

Para una configuración local del proyecto, crea un archivo .env en la raíz de tu repositorio git:
Después inicia Aider normalmente:
Aider también lee .env desde tu directorio home. Los valores de la raíz del repositorio tienen prioridad sobre los del directorio home. Mantén este archivo fuera de git: añade .env a .gitignore si aún no está ignorado.
También puedes establecer AIDER_OPENAI_API_BASE y AIDER_OPENAI_API_KEY. La documentación oficial de Aider sigue documentando OPENAI_API_BASE y OPENAI_API_KEY para proveedores compatibles con OpenAI.

​
Persistir la configuración con YAML

Puedes almacenar la misma configuración en .aider.conf.yml en la raíz de tu repositorio o en tu directorio home:
Después ejecuta:

​
Verifica la configuración

Después de que Aider arranque, pídele algo pequeño que demuestre que el modelo está accesible:
Si el endpoint y la clave son correctos, Aider transmitirá una respuesta desde el modelo de Venice seleccionado. También puedes confirmar la API key fuera de Aider:

​
Elección de modelos

Antepón siempre openai/ a los IDs de modelos de Venice al lanzar Aider. Sin ese prefijo, Aider no enrutará la solicitud por la ruta del proveedor compatible con OpenAI. Descubre los IDs de modelos actuales en tiempo de ejecución:
O consulta GET /models/traits para valores por defecto como text:default.

​
Notas de configuración

  • Mantén OPENAI_API_BASE establecido en https://api.venice.ai/api/v1. No añadas /chat/completions; Aider añade la ruta del chat por sí mismo.
  • Usa una API key de Venice en OPENAI_API_KEY. No uses una clave de OpenAI con la URL base de Venice.
  • Aider puede advertir que el modelo tiene una ventana de contexto o coste desconocidos. Esa advertencia es esperada para muchos IDs de modelos de Venice y normalmente se puede ignorar. Consulta advertencias de modelo de Aider.
  • Prefiere modelos capaces de programar/razonar para ediciones multiarchivo. Los modelos más pequeños o no orientados a código pueden tener problemas con los formatos de edición de Aider.
Establecer OPENAI_API_BASE y OPENAI_API_KEY en tu shell también afecta a otras herramientas que leen esas variables. Prefiere un .env de proyecto o .aider.conf.yml si usas OpenAI en otras partes del mismo entorno.

​
Solución de problemas

Confirma que OPENAI_API_KEY es una clave de Venice desde venice.ai/settings/api, sin espacios en blanco adicionales. En Windows, después de setx, reinicia la terminal.
Confirma que el ID del modelo existe en el catálogo de modelos de texto y que has lanzado Aider con el prefijo openai/, por ejemplo openai/zai-org-glm-5-1.
Comprueba que OPENAI_API_BASE es exactamente https://api.venice.ai/api/v1 en la misma sesión de shell. Imprímelo con echo $OPENAI_API_BASE (o $env:OPENAI_API_BASE en PowerShell).
Es esperado para muchos modelos de Venice. Aider recurre a valores predeterminados razonables. Para silenciarla, añade metadatos del modelo como se describe en ajustes avanzados de modelo de Aider.

​
Recursos

Modelos de texto de Venice

Explora los IDs de modelo disponibles en Venice

Documentación compatible con OpenAI de Aider

Configuración oficial de proveedor de Aider

Configuración de Aider con .env

Persiste las API keys y los ajustes de modelo

Referencia de la API de Venice

Documentación completa de endpoints y parámetros