SuperCoder: asistente de codificación para la terminal 59

¿Qué es SuperCoder?

SuperCoder es un asistente de codificación que se ejecuta en la terminal y ayuda a los desarrolladores a simplificar el flujo de trabajo de desarrollo. Sus funciones incluyen: búsqueda rápida de código, visualización de la estructura del proyecto, modificación de código mediante instrucciones en lenguaje natural y corrección de errores. La instalación es muy sencilla: descarga el paquete ZIP desde el sitio web oficial, descomprímelo y añade la ruta de los archivos correspondientes al PATH del sistema; luego podrás iniciarlo con un comando en la terminal. Es compatible con múltiples entornos de desarrollo, como Python y varios frameworks comunes, lo que lo hace muy práctico.

Funciones principales de SuperCoder

• Búsqueda de código: permite realizar búsquedas de código complejas dentro del proyecto y localizar rápidamente patrones de código específicos.

• Exploración de la estructura del proyecto: ofrece una vista de la organización de carpetas y archivos del proyecto, lo que facilita la navegación por el mismo.

• Edición de código: admite la modificación fluida del código del proyecto mediante comandos en lenguaje natural.

• Corrección de errores: corrige automáticamente los errores en el código y realiza mejoras según las solicitudes detalladas del usuario.

• Soporte de reglas de Cursor: utiliza las reglas de Cursor para comprender de forma inteligente y modificar el código en la ubicación precisa.

• Lectura de archivos: lee y muestra el contenido de un archivo especificado.

• Ejecución de comandos: ejecuta comandos de shell según sea necesario.

Herramientas compatibles

• CodeSearchTool: se utiliza para buscar patrones de código específicos dentro de un proyecto.

• CodeEditTool: permite editar archivos dentro de un proyecto.

• FileReadTool: lee y muestra el contenido de los archivos.

• ProjectStructureTool: ofrece una visión general de las carpetas y archivos del proyecto.

• CommandExecutionTool: ejecuta comandos de shell según la evaluación del agente.

¿Para quién es adecuado?

• Programadores que prefieren trabajar con la terminal.

• Empresas y desarrolladores que necesitan desarrollar e implementar sistemas de software de forma rápida.

Cómo usar SuperCoder

Pasos de instalación

1. Descarga el paquete ZIP desde la página de Release.

2. Descomprime el paquete ZIP en una carpeta de tu ordenador y asegúrate de que el binario bin/supercoder o bin/supercoder.bat sea accesible desde el PATH del sistema.

3. En la terminal, ejecuta el comando supercoder desde cualquier carpeta en la que desees trabajar.

Configuración del agente

Uso de la API de Openai

Antes de ejecutar el agente, es necesario configurar la variable de entorno OPENAI_API_KEY. Puedes obtener la clave de la API registrándote en OpenAI.

export OPENAI_API_KEY=export OPENAI_MODEL= # El valor predeterminado es "o3-mini"; ten en cuenta los costes

Uso de un modelo local o cualquier API compatible con OpenAI

Si dispones de un modelo local o de otra API compatible con OpenAI, puedes configurar SuperCoder para que lo utilice estableciendo las siguientes variables de entorno:

export SUPERCODER_BASE_URL=export SUPERCODER_API_KEY=export SUPERCODER_MODEL=

Si utilizas Google Gemini, también debes establecer SUPERCODER_GEMINI_MODE=true. Ten en cuenta que el modelo utilizado debe ser compatible con la llamada a herramientas.

Ejecución del agente de codificación

Después de construir el proyecto, extrae y ejecuta el binario generado. Una vez en funcionamiento, puedes introducir comandos en lenguaje natural, por ejemplo:

"Search for usage of function XYZ"
"Edit file path/to/file.scala to add a new method"
"Show me the project structure"

El agente interpretará estos comandos y llamará a las herramientas correspondientes.

Configuración del entorno de desarrollo

Requisitos previos

• Java 8 o superior

• SBT (herramienta de construcción de Scala)

Pasos

1. Clona el repositorio:

git clone cd SuperCoder

2. Construye el proyecto con SBT:

sbt compile

3. Ejecuta las pruebas para asegurarte de que todo funciona correctamente:

sbt test

Dirección del proyecto

Repositorio de GitHub:https://github.com/huytd/supercoder