my-free-code (hkqr/my-free-code, 731 estrellas en GitHub a fecha de 2026) emerge como una solución clave en el desarrollo de agentes de código, ofreciendo un gateway multiproveedor que centraliza y optimiza la interacción con modelos de lenguaje. Esta herramienta, en su versión 0.8, permite a los desarrolladores utilizar agentes como Claude Code sin la dependencia de un único proveedor, enrutando el tráfico entre más de 40 servicios diferentes. Su capacidad para exponer una API compatible con Anthropic Messages y OpenAI Responses la posiciona como un componente versátil para la creación de aplicaciones de código.
¿Qué problema resuelve my-free-code en el desarrollo de agentes de código?
my-free-code aborda la fragmentación y la dependencia de proveedores específicos en el ecosistema de los modelos de lenguaje para agentes de código, proporcionando un gateway unificado. Esta herramienta permite a los desarrolladores integrar múltiples servicios de IA, como OpenRouter, Groq, Azure OpenAI o Google Vertex, bajo una única interfaz de programación de aplicaciones (API), lo que simplifica la gestión y ofrece flexibilidad sin precedentes. Al desacoplar el agente de código del proveedor subyacente, my-free-code facilita la experimentación, la optimización de costes y la resiliencia operativa, asegurando que el desarrollo no quede atado a las limitaciones o interrupciones de un solo servicio.
¿Cómo funciona la arquitectura de enrutamiento de modelos?
La arquitectura de my-free-code se basa en un gateway FastAPI que actúa como intermediario entre los agentes de código y los diversos proveedores de modelos de lenguaje, gestionando el enrutamiento y la lógica de fallback. Este diseño separa claramente los protocolos de comunicación (como Anthropic Messages y OpenAI Responses) de la lógica de enrutamiento y la ejecución del proveedor, lo que garantiza una alta modularidad. El sistema incluye una capa de tiempo de ejecución del proveedor que maneja las particularidades de cada servicio, desde adaptadores compatibles con OpenAI hasta implementaciones especializadas para proveedores con protocolos únicos. Además, my-free-code incorpora un enrutador de modelos que permite configurar prioridades y fallbacks ordenados, redirigiendo automáticamente las solicitudes a modelos alternativos si el principal falla o no está disponible, mejorando la fiabilidad de las operaciones.
Por ejemplo, si se configura MODEL_SONNET = deepseek/deepseek-chat y FALLBACK_MODELS = groq/llama-3.3-70b-versatile,ollama/llama3.1, una solicitud para el modelo Sonnet intentará primero DeepSeek Chat. Si este falla antes de generar una salida, el gateway intentará Groq Llama 3.1 70B y, finalmente, Ollama Llama 3.1. Esta estrategia de fallback garantiza la continuidad del servicio, aunque, una vez que la transmisión de una respuesta ha comenzado, el gateway no cambia de proveedor para evitar duplicidades o inconsistencias.
¿Qué capacidades de integración ofrece my-free-code para diferentes proveedores?
my-free-code proporciona una amplia capacidad de integración con más de 40 proveedores de modelos de lenguaje, ofreciendo una API unificada que abstrae las complejidades de cada servicio individual. Esta compatibilidad se extiende a protocolos como Anthropic Messages y OpenAI Responses, permitiendo a los desarrolladores interactuar con una vasta gama de modelos sin necesidad de adaptar su código a cada API específica. La plataforma soporta proveedores de gran escala como Azure OpenAI, Google Vertex y Amazon Bedrock, así como servicios más especializados como DeepSeek, Mistral, Cerebras y soluciones locales como Ollama Cloud y LM Studio.
La clave de esta integración reside en su capa de adaptadores. Los proveedores con protocolos estándar compatibles con OpenAI utilizan un transporte compartido, mientras que aquellos con autenticación o protocolos inusuales requieren un adaptador dedicado. Esta flexibilidad asegura que my-free-code pueda incorporar nuevos servicios de IA de manera eficiente, manteniendo la coherencia en la interacción del desarrollador. Además, la herramienta incluye funcionalidades avanzadas como streaming SSE (Server-Sent Events), llamadas a herramientas (tool calls), gestión de resultados de herramientas, y la capacidad de pasar metadatos, lo que enriquece la interacción con los modelos y permite la creación de agentes de código más sofisticados.
¿Cómo optimiza my-free-code el rendimiento y la resiliencia?
my-free-code incorpora varias características diseñadas para optimizar el rendimiento y la resiliencia de los agentes de código, asegurando una operación fluida y robusta. Una de las funcionalidades clave es el backoff de salud por proveedor, que monitoriza el estado de cada servicio de IA y reduce la frecuencia de las solicitudes a aquellos que muestran problemas, evitando así la saturación y mejorando la estabilidad general del sistema. Esta estrategia proactiva minimiza el impacto de posibles interrupciones en un proveedor específico.
Además, el gateway gestiona la concurrencia y el control de ventanas de tasa (rate-windowing), lo que permite regular el número de solicitudes simultáneas y la tasa de envío de peticiones a cada proveedor. Esto es crucial para cumplir con los límites de uso de las APIs y evitar bloqueos, al tiempo que se maximiza el rendimiento dentro de los parámetros permitidos. La combinación de fallbacks ordenados de modelos, la gestión de la salud del proveedor y el control de concurrencia garantiza que los agentes de código puedan operar de manera continua y eficiente, incluso frente a fluctuaciones en la disponibilidad o el rendimiento de los servicios de IA subyacentes.
¿Qué herramientas adicionales ofrece my-free-code para la gestión y depuración?
my-free-code no solo facilita la interacción con modelos de lenguaje, sino que también proporciona herramientas adicionales para la gestión y depuración, mejorando la experiencia del desarrollador. Incluye una interfaz de usuario de administración local (Admin UI) accesible a través de /admin, que permite supervisar el estado del gateway y los proveedores configurados. Esta interfaz ofrece una visión clara del funcionamiento del sistema, facilitando la identificación de problemas y la optimización de la configuración.
Además de la interfaz gráfica, my-free-code expone una API de administración autenticada (/api/admin/*) que permite consultar programáticamente el estado, los modelos disponibles y los proveedores. Esto es particularmente útil para la automatización de tareas de monitoreo y la integración con sistemas de gestión existentes. La capacidad de configurar modelos específicos para diferentes niveles de Claude (Fable, Opus, Sonnet, Haiku) y la gestión de la identidad pública del modelo, incluso cuando la solicitud se enruta a un proveedor diferente, contribuyen a una experiencia de desarrollo más controlada y transparente. Estas funcionalidades son esenciales para mantener la eficiencia y la fiabilidad en entornos de desarrollo complejos.
¿Cómo se integra my-free-code con entornos de desarrollo y agentes de código existentes?
my-free-code se integra de manera flexible con diversos entornos de desarrollo y agentes de código existentes, actuando como un launcher para facilitar su uso. La herramienta proporciona adaptadores para una amplia gama de agentes, incluyendo Claude Code, Codex, Pi, OpenCode, Cline, Hermes, DeepSeek Harness, Grok y Muse. Estos launchers simplifican la configuración del entorno de proxy local y delegan los argumentos necesarios al cliente instalado, permitiendo que los desarrolladores utilicen sus agentes preferidos sin modificaciones significativas en su flujo de trabajo.
Para utilizar my-free-code con Claude Code, por ejemplo, basta con configurar las variables de entorno ANTHROPIC_BASE_URL para apuntar a la dirección local del gateway (por defecto, http://127.0.0.1:8082) y ANTHROPIC_AUTH_TOKEN con el valor "local". Además, la variable CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY = "1" permite al agente descubrir los modelos disponibles a través del gateway. Esta abstracción de la capa de proveedor permite a los desarrolladores centrarse en la lógica de sus agentes, aprovechando las capacidades de enrutamiento y fallback de my-free-code. Para más información sobre herramientas de IA, puedes visitar nuestro hub de herramientas de IA.
¿Qué implicaciones tiene my-free-code para la soberanía de datos y la flexibilidad de modelos?
my-free-code ofrece implicaciones significativas para la soberanía de datos y la flexibilidad en la elección de modelos, empoderando a los desarrolladores con mayor control sobre sus operaciones de IA. Al permitir el enrutamiento del tráfico a través de múltiples proveedores, la herramienta reduce la dependencia de un único servicio, lo que puede ser crucial para cumplir con regulaciones de datos específicas de cada región o industria. Si un proveedor no cumple con los requisitos de soberanía de datos, el tráfico puede redirigirse fácilmente a otro que sí lo haga, sin alterar la lógica del agente de código.
Esta flexibilidad también se extiende a la elección de modelos. Los desarrolladores no están atados a las ofertas de un solo proveedor, pudiendo seleccionar el modelo más adecuado para cada tarea en función de su rendimiento, coste o características específicas. "Tu agente, tu router de modelos" es el lema que mejor describe esta filosofía, permitiendo a los equipos de desarrollo tomar decisiones estratégicas sobre dónde y cómo se procesan sus datos y se ejecutan sus modelos. La capacidad de integrar modelos locales, como los gestionados por Ollama o LM Studio, refuerza aún más esta soberanía, permitiendo procesar información sensible en infraestructuras controladas por el propio usuario. Esto es especialmente relevante en sectores con alta exigencia de privacidad, como la salud o las finanzas. Para profundizar en cómo las empresas están adoptando estas tecnologías, consulta nuestro artículo sobre cómo las empresas están adoptando la IA en 2026.
¿Cómo se instala y configura my-free-code para un uso local?
La instalación y configuración de my-free-code para un uso local es un proceso sencillo que permite a los desarrolladores poner en marcha el gateway rápidamente. El primer paso es asegurar que se tiene Python 3.10 o superior instalado. A continuación, se crea un entorno virtual y se instalan las dependencias necesarias.
El proceso general de instalación es el siguiente:
- Crear y activar un entorno virtual:
bash
python -m venv .venv # En Windows: .venv\Scripts\Activate.ps1 # En macOS/Linux: source .venv/bin/activate - Instalar las dependencias:
bash
python -m pip install -r requirements.txt - Copiar el archivo de configuración de entorno:
bash
cp .env.example .env - Iniciar my-free-code:
bash
python -m my_free_code
Una vez iniciado, el gateway estará disponible por defecto en http://127.0.0.1:8082. Para configurar los modelos, se edita el archivo .env y se definen las variables MODEL, MODEL_SONNET, MODEL_HAIKU, MODEL_OPUS y FALLBACK_MODELS con los identificadores de los modelos y proveedores deseados. Por ejemplo:
MODEL = open_router/openrouter/free
MODEL_SONNET = deepseek/deepseek-chat
MODEL_HAIKU = groq/llama-3.3-70b-versatile
MODEL_OPUS = nvidia_nim/meta/llama-3.3-70b-instruct
FALLBACK_MODELS = deepseek/deepseek-chat,ollama/llama3.1Es crucial también establecer las claves de API correspondientes en el archivo .env para los proveedores seleccionados. Para la seguridad, se recomienda mantener HOST=127.0.0.1, establecer un PROXY_AUTH_TOKEN no trivial y nunca subir el archivo .env a repositorios públicos. Esta configuración local es ideal para el desarrollo y las pruebas, ofreciendo un entorno controlado y seguro. Para más detalles sobre cómo proteger tus aplicaciones, puedes revisar nuestro artículo sobre seguridad en el desarrollo de IA.
Preguntas frecuentes
¿Qué es my-free-code y para qué sirve?
my-free-code es un gateway multiproveedor de código abierto que permite a los desarrolladores enrutar el tráfico entre múltiples servicios de modelos de lenguaje (LLM) para agentes de código, como Claude Code. Sirve para unificar la interacción con más de 40 proveedores de IA, ofreciendo flexibilidad, resiliencia y optimización de costes al evitar la dependencia de un único servicio.
¿Qué proveedores de modelos de lenguaje soporta my-free-code?
my-free-code soporta una amplia gama de proveedores, incluyendo OpenRouter, Groq, Azure OpenAI, Google Vertex, Amazon Bedrock, DeepSeek, Mistral, Cerebras, Ollama Cloud y LM Studio, entre otros. En total, integra más de 40 servicios diferentes, adaptándose a sus protocolos específicos a través de adaptadores.
¿my-free-code es compatible con las APIs de Anthropic y OpenAI?
Sí, my-free-code expone una API compatible con Anthropic Messages (/v1/messages) y OpenAI Responses (/v1/responses), lo que permite a los agentes de código interactuar con el gateway utilizando protocolos estándar sin necesidad de adaptaciones complejas para cada proveedor subyacente.
¿Cómo maneja my-free-code las fallas de los proveedores?
my-free-code implementa un mecanismo de fallback ordenado de modelos y un backoff de salud por proveedor. Si un modelo principal falla, el gateway redirige automáticamente la solicitud a un modelo alternativo configurado. El backoff de salud reduce la frecuencia de solicitudes a proveedores con problemas, mejorando la resiliencia del sistema.
¿Puedo usar my-free-code para modelos de lenguaje locales?
Sí, my-free-code permite la integración con modelos de lenguaje locales gestionados por plataformas como Ollama y LM Studio. Esto se configura estableciendo las variables de entorno OLLAMA_BASE_URL o LM_STUDIO_BASE_URL y especificando el modelo local en la configuración del gateway.