🤖 Modelos Disponibles (Lista Gratuita)

⚠️ Importante: La disponibilidad de modelos depende de tu plan de Kiro (gratuito/pago). El gateway proporciona acceso a los modelos disponibles en tu IDE o CLI según tu suscripción. La lista a continuación muestra los modelos comúnmente disponibles en el plan gratuito.

🔒 Claude Opus 4.5 fue eliminado del plan gratuito el 17 de enero de 2026. Puede estar disponible en planes de pago — verifica la lista de modelos en tu IDE/CLI.

🚀 Claude Sonnet 4.5 — Rendimiento equilibrado. Excelente para programación, escritura y tareas de propósito general.

⚡ Claude Haiku 4.5 — Velocidad relámpago. Perfecto para respuestas rápidas, tareas simples y chat.

📦 Claude Sonnet 4 — Generación anterior. Todavía potente y confiable para la mayoría de casos de uso.

💤 GLM-5 — Modelo MoE abierto (744B parámetros, 40B activos). Modelo avanzado para ingeniería de sistemas complejos y tareas agénticas de largo alcance.

🐋 DeepSeek-V3.2 — Modelo MoE abierto (685B parámetros, 37B activos). Rendimiento equilibrado para programación, razonamiento y tareas generales.

🧩 MiniMax M2.5 — Modelo MoE abierto (230B parámetros, 10B activos). Versión mejorada con capacidades ampliadas de razonamiento y manejo de tareas.

🧩 MiniMax M2.1 — Modelo MoE abierto (230B parámetros, 10B activos). Excelente para tareas complejas, planificación y flujos de trabajo multietapa.

🤖 Qwen3-Coder-Next — Modelo MoE abierto (80B parámetros, 3B activos). Enfocado en programación. Excelente para desarrollo y proyectos grandes.

💡 Resolución Inteligente de Modelos: Usa cualquier formato de nombre de modelo — claude-sonnet-4-5, claude-sonnet-4.5, o incluso nombres versionados como claude-sonnet-4-5-20250929. El gateway los normaliza automáticamente.

✨ Características

🚀 Inicio Rápido

Elige tu método de implementación:

• 🐍 Python Nativo - Control total, depuración fácil
• 🐳 Docker - Entorno aislado, implementación fácil → ir a Docker

Prerrequisitos

• Python 3.10+
• Uno de los siguientes:
  • Kiro IDE con cuenta iniciada, O
  • Kiro CLI con AWS SSO (AWS IAM Identity Center, OIDC) - Builder ID gratuito o cuenta empresarial

Instalación

# Clona el repositorio (requiere Git)
git clone https://github.com/Jwadow/kiro-gateway.git
cd kiro-gateway

# O descarga el ZIP: Code → Download ZIP → extrae → abre la carpeta kiro-gateway

# Instala las dependencias
pip install -r requirements.txt

# Configura (ver sección Configuración)
cp .env.example .env
# Copia y edita .env con tus credenciales

# Inicia el servidor
python main.py

# O con puerto personalizado (si 8000 está ocupado)
python main.py --port 9000

El servidor estará disponible en http://localhost:8000

⚙️ Configuración

💡 Usuarios avanzados: ¿Buscas soporte para múltiples cuentas? Consulta Sistema de Cuentas abajo.

Opción 1: Archivo JSON de Credenciales (Kiro IDE / Enterprise)

Especifica la ruta al archivo de credenciales:

Funciona con:

• Kiro IDE (estándar) - para cuentas personales
• Enterprise - para cuentas empresariales con SSO

KIRO_CREDS_FILE="~/.aws/sso/cache/kiro-auth-token.json"

# Contraseña para proteger TU servidor proxy (crea cualquier cadena segura)
# Usarás esto como api_key al conectarte a tu gateway
PROXY_API_KEY="my-super-secret-password-123"

{
  "accessToken": "eyJ...",
  "refreshToken": "eyJ...",
  "expiresAt": "2025-01-12T23:00:00.000Z",
  "profileArn": "arn:aws:codewhisperer:us-east-1:...",
  "region": "us-east-1",
  "clientIdHash": "abc123..."  // Optional: for corporate SSO setups
}

Opción 2: Variables de Entorno (archivo .env)

Crea un archivo .env en la raíz del proyecto:

# Requerido
REFRESH_TOKEN="tu_kiro_refresh_token"

# Contraseña para proteger TU servidor proxy (crea cualquier cadena segura)
PROXY_API_KEY="my-super-secret-password-123"

# Opcional
PROFILE_ARN="arn:aws:codewhisperer:us-east-1:..."
KIRO_REGION="us-east-1"

Opción 3: Credenciales AWS SSO (kiro-cli / Enterprise)

Si usas kiro-cli o Kiro IDE con AWS SSO (AWS IAM Identity Center), el gateway detectará y usará automáticamente la autenticación apropiada.

Funciona tanto con cuentas Builder ID gratuitas como con cuentas empresariales.

KIRO_CREDS_FILE="~/.aws/sso/cache/your-sso-cache-file.json"

# Contraseña para proteger TU servidor proxy
PROXY_API_KEY="my-super-secret-password-123"

# Nota: PROFILE_ARN NO es necesario para AWS SSO (Builder ID y cuentas empresariales)
# El gateway funcionará sin él

{
  "accessToken": "eyJ...",
  "refreshToken": "eyJ...",
  "expiresAt": "2025-01-12T23:00:00.000Z",
  "region": "us-east-1",
  "clientId": "...",
  "clientSecret": "..."
}

Opción 4: Base de datos SQLite de kiro-cli

Si usas kiro-cli y prefieres usar su base de datos SQLite directamente:

KIRO_CLI_DB_FILE="~/.local/share/kiro-cli/data.sqlite3"

# Contraseña para proteger TU servidor proxy
PROXY_API_KEY="my-super-secret-password-123"

# Nota: PROFILE_ARN NO es necesario para AWS SSO (Builder ID y cuentas empresariales)
# El gateway funcionará sin él

Obtener Credenciales

Para usuarios de Kiro IDE:

• Inicia sesión en Kiro IDE y usa la Opción 1 arriba (archivo JSON de credenciales)
• El archivo de credenciales se crea automáticamente después de iniciar sesión

Para usuarios de Kiro CLI:

• Inicia sesión con kiro-cli login y usa la Opción 3 u Opción 4 arriba
• ¡No se necesita extracción manual de tokens!

🔀 Sistema de Cuentas (Avanzado)

El Sistema de Cuentas es una forma de gestionar múltiples cuentas de Kiro con conmutación automática por fallo. En el futuro, este sistema reemplazará el archivo .env para la configuración de credenciales, pero actualmente es opcional e indicado para quienes desean usar múltiples cuentas.

Por Qué lo Necesitas

Si tienes múltiples cuentas de Kiro, el gateway puede cambiar automáticamente entre ellas cuando una cuenta no está disponible temporalmente.

El sistema también funciona con una sola cuenta — simplemente sin conmutación.

Cómo Habilitarlo

Añade a tu .env:

ACCOUNT_SYSTEM=true

Qué sucede:

• En el primer inicio, tus credenciales de .env se migran automáticamente a credentials.json (una sola vez)
• Después, todos los parámetros de cuenta y región de .env se ignoran
• La gestión de cuentas solo se realiza a través de credentials.json

[
  {
    "type": "json",
    "path": "~/.aws/sso/cache/kiro-auth-token.json"
  }
]

[
  {
    "type": "json",
    "path": "~/.aws/sso/cache/kiro-auth-token.json"
  },
  {
    "type": "sqlite",
    "path": "~/.local/share/kiro-cli/data.sqlite3"
  },
  {
    "type": "refresh_token",
    "refresh_token": "eyJhbGc...",
    "profile_arn": "arn:aws:codewhisperer:us-east-1:..."
  }
]

[
  {
    "type": "json",
    "path": "C:\\MyAccs\\kiro67"
  }
]

Cómo Funciona la Conmutación

Cuando una cuenta devuelve un error (límite de velocidad 429, cuota superada 402), el gateway intenta automáticamente la siguiente cuenta de la lista. Si una cuenta falla varias veces seguidas, el gateway deja de usarla temporalmente y verifica periódicamente si se ha recuperado.

Para una sola cuenta, la conmutación no funciona — recibirás el error original de la API de Kiro.

Para ejemplos de configuración completos (incluyendo parámetros de región por cuenta), consulta credentials.json.example.

🐳 Docker Deployment

Implementación basada en Docker. ¿Prefieres Python nativo? Consulta Inicio Rápido arriba.

Inicio Rápido

# 1. Clona y configura
git clone https://github.com/Jwadow/kiro-gateway.git
cd kiro-gateway
cp .env.example .env
# Edita .env con tus credenciales

# 2. Ejecuta con docker-compose
docker-compose up -d

# 3. Verifica el estado
docker-compose logs -f
curl http://localhost:8000/health

Docker Run (Sin Compose)

docker run -d \
  -p 8000:8000 \
  -e PROXY_API_KEY="my-super-secret-password-123" \
  -e REFRESH_TOKEN="your_refresh_token" \
  --name kiro-gateway \
  ghcr.io/jwadow/kiro-gateway:latest

docker run -d \
  -p 8000:8000 \
  -v ~/.aws/sso/cache:/home/kiro/.aws/sso/cache:ro \
  -e KIRO_CREDS_FILE=/home/kiro/.aws/sso/cache/kiro-auth-token.json \
  -e PROXY_API_KEY="my-super-secret-password-123" \
  --name kiro-gateway \
  ghcr.io/jwadow/kiro-gateway:latest

docker run -d `
  -p 8000:8000 `
  -v ${HOME}/.aws/sso/cache:/home/kiro/.aws/sso/cache:ro `
  -e KIRO_CREDS_FILE=/home/kiro/.aws/sso/cache/kiro-auth-token.json `
  -e PROXY_API_KEY="my-super-secret-password-123" `
  --name kiro-gateway `
  ghcr.io/jwadow/kiro-gateway:latest

docker run -d -p 8000:8000 --env-file .env --name kiro-gateway ghcr.io/jwadow/kiro-gateway:latest

Configuración de Docker Compose

Edita docker-compose.yml y descomenta los montajes de volumen para tu SO:

volumes:
  # Credenciales de Kiro IDE (elige tu SO)
  - ~/.aws/sso/cache:/home/kiro/.aws/sso/cache:ro              # Linux/macOS
  # - ${USERPROFILE}/.aws/sso/cache:/home/kiro/.aws/sso/cache:ro  # Windows
  
  # Base de datos kiro-cli (elige tu SO)
  - ~/.local/share/kiro-cli:/home/kiro/.local/share/kiro-cli  # Linux/macOS
  # - ${USERPROFILE}/.local/share/kiro-cli:/home/kiro/.local/share/kiro-cli  # Windows
  
  # Logs de depuración (opcional)
  - ./debug_logs:/app/debug_logs

Comandos de Gestión

docker-compose logs -f      # Ver logs
docker-compose restart      # Reiniciar
docker-compose down         # Detener
docker-compose pull && docker-compose up -d  # Actualizar

docker build -t kiro-gateway .
docker run -d -p 8000:8000 --env-file .env kiro-gateway

🌐 Soporte de VPN/Proxy

Para usuarios en China, redes corporativas o regiones con problemas de conectividad a servicios de AWS.

El gateway admite enrutar todas las solicitudes de Kiro API a través de un servidor VPN o proxy. Esto es esencial si experimenta problemas de conexión a puntos finales de AWS o necesita usar un proxy corporativo.

Configuración

Añade a tu archivo .env:

# Proxy HTTP
VPN_PROXY_URL=http://127.0.0.1:7890

# Proxy SOCKS5
VPN_PROXY_URL=socks5://127.0.0.1:1080

# Con autenticación (proxies corporativos)
VPN_PROXY_URL=http://username:[email protected]:8080

# Sin protocolo (por defecto http://)
VPN_PROXY_URL=192.168.1.100:8080

Protocolos Soportados

• ✅ HTTP — Protocolo proxy estándar
• ✅ HTTPS — Conexiones proxy seguras
• ✅ SOCKS5 — Protocolo proxy avanzado (común en software VPN)
• ✅ Autenticación — Usuario/contraseña incrustados en URL

Cuándo lo Necesitas

Software VPN Popular con Soporte Proxy

La mayoría de clientes VPN proporcionan un servidor proxy local:

• Sing-box — Cliente VPN moderno con soporte HTTP/SOCKS5 proxy
• Clash — Generalmente se ejecuta en http://127.0.0.1:7890
• V2Ray — Proxy SOCKS5/HTTP configurable
• Shadowsocks — Soporte proxy SOCKS5
• VPN Corporativo — Consulta a tu departamento de TI para configuración de proxy

Deja VPN_PROXY_URL vacío (por defecto) si no necesitas soporte proxy.

📡 Referencia de API

Endpoints

💡 Ejemplos de Uso

OpenAI API

curl http://localhost:8000/v1/chat/completions \
  -H "Authorization: Bearer my-super-secret-password-123" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "messages": [{"role": "user", "content": "¡Hola!"}],
    "stream": true
  }'

curl http://localhost:8000/v1/chat/completions \
  -H "Authorization: Bearer my-super-secret-password-123" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "messages": [
      {"role": "system", "content": "Eres un asistente útil."},
      {"role": "user", "content": "¿Cuánto es 2+2?"}
    ],
    "stream": true
  }'

curl http://localhost:8000/v1/chat/completions \
  -H "Authorization: Bearer my-super-secret-password-123" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "messages": [{"role": "user", "content": "¿Cómo está el clima en Londres?"}],
    "tools": [{
      "type": "function",
      "function": {
        "name": "get_weather",
        "description": "Obtener el clima para una ubicación",
        "parameters": {
          "type": "object",
          "properties": {
            "location": {"type": "string", "description": "Nombre de la ciudad"}
          },
          "required": ["location"]
        }
      }
    }]
  }'

from openai import OpenAI

client = OpenAI(
    base_url="http://localhost:8000/v1",
    api_key="my-super-secret-password-123"  # Tu PROXY_API_KEY del .env
)

response = client.chat.completions.create(
    model="claude-sonnet-4-5",
    messages=[
        {"role": "system", "content": "Eres un asistente útil."},
        {"role": "user", "content": "¡Hola!"}
    ],
    stream=True
)

for chunk in response:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    base_url="http://localhost:8000/v1",
    api_key="my-super-secret-password-123",  # Tu PROXY_API_KEY del .env
    model="claude-sonnet-4-5"
)

response = llm.invoke("Hola, ¿cómo estás?")
print(response.content)

Anthropic API

curl http://localhost:8000/v1/messages \
  -H "x-api-key: my-super-secret-password-123" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "¡Hola!"}]
  }'

curl http://localhost:8000/v1/messages \
  -H "x-api-key: my-super-secret-password-123" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 1024,
    "system": "Eres un asistente útil.",
    "messages": [{"role": "user", "content": "¡Hola!"}]
  }'

curl http://localhost:8000/v1/messages \
  -H "x-api-key: my-super-secret-password-123" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 1024,
    "stream": true,
    "messages": [{"role": "user", "content": "¡Hola!"}]
  }'

import anthropic

client = anthropic.Anthropic(
    api_key="my-super-secret-password-123",  # Tu PROXY_API_KEY del .env
    base_url="http://localhost:8000"
)

# Sin streaming
response = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "¡Hola!"}]
)
print(response.content[0].text)

# Con streaming
with client.messages.stream(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "¡Hola!"}]
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

🔧 Depuración

El registro de depuración está deshabilitado por defecto. Para habilitar, añade a tu .env:

# Modo de registro de depuración:
# - off: deshabilitado (predeterminado)
# - errors: guardar logs solo para solicitudes fallidas (4xx, 5xx) - recomendado para solución de problemas
# - all: guardar logs para cada solicitud (sobrescribe en cada solicitud)
DEBUG_MODE=errors

Modos de Depuración

Archivos de Depuración

Cuando está habilitado, las solicitudes se registran en la carpeta debug_logs/:

📜 Licencia

Este proyecto está licenciado bajo la GNU Affero General Public License v3.0 (AGPL-3.0).

Esto significa:

• ✅ Puedes usar, modificar y distribuir este software
• ✅ Puedes usarlo con fines comerciales
• ⚠️ Debes revelar el código fuente cuando distribuyas el software
• ⚠️ El uso en red es distribución — si ejecutas una versión modificada en un servidor y permites que otros interactúen con ella, debes hacer el código fuente disponible para ellos
• ⚠️ Las modificaciones deben ser liberadas bajo la misma licencia

Consulta el archivo LICENSE para el texto completo de la licencia.

¿Por qué AGPL-3.0?

AGPL-3.0 asegura que las mejoras a este software beneficien a toda la comunidad. Si modificas este gateway y lo despliegas como un servicio, debes compartir tus mejoras con tus usuarios.

Acuerdo de Licencia de Contribuidor (CLA)

Al enviar una contribución a este proyecto, aceptas los términos de nuestro Acuerdo de Licencia de Contribuidor (CLA). Esto asegura que:

• Tienes el derecho de enviar la contribución
• Otorgas al mantenedor derechos para usar y relicenciar tu contribución
• El proyecto permanece legalmente protegido

💖 Apoya el Proyecto

¡Si este proyecto te ahorró tiempo o dinero, considera apoyarlo!

Cada contribución ayuda a mantener este proyecto vivo y creciendo

🤑 Donar

☕ Apoyo Único

🪙 O envía criptomonedas

Moneda	Red	Dirección
USDT	TRC20	TSVtgRc9pkC1UgcbVeijBHjFmpkYHDRu26
BTC	Bitcoin	12GZqxqpcBsqJ4Vf1YreLqwoMGvzBPgJq6
ETH	Ethereum	0xc86eab3bba3bbaf4eb5b5fff8586f1460f1fd395
SOL	Solana	9amykF7KibZmdaw66a1oqYJyi75fRqgdsqnG66AK3jvh
TON	TON	UQBVh8T1H3GI7gd7b-_PPNnxHYYxptrcCVf3qQk5v41h3QTM

⚠️ Descargo de Responsabilidad

Este proyecto no está afiliado, respaldado ni patrocinado por Amazon Web Services (AWS), Anthropic o Kiro IDE. Úsalo bajo tu propio riesgo y en cumplimiento con los términos de servicio de las APIs subyacentes.