Saltar al contenido principal

​
Cómo funciona Fireworks AI

Fireworks AI es la plataforma de inferencia más rápida para IA generativa, diseñada para construir y ejecutar aplicaciones de IA en segundos. La plataforma proporciona acceso sin servidor a modelos de código abierto populares como DeepSeek, Llama, Qwen y Mistral con velocidad optimizada, alto rendimiento y latencia mínima. Construido para desarrolladores que necesitan infraestructura de IA confiable y ultrarrápida sin la complejidad de la gestión de GPUs.

​
Modelos Recomendados

Recomendamos buenos modelos de codificación con precios competitivos y ventanas de contexto altas.
Para la información más actualizada, visita la página de precios de Fireworks AI.
ModeloPrecio (1M tokens)Ventana de contexto
Llama 4 Maverick recomendado0.22/0.22/0.88~131k tokens
Llama 4 Scout0.15/0.15/0.60~131k tokens
DeepSeek V3$0.90~128k tokens
Qwen3 235B0.22/0.22/0.88~131k tokens

​
Crear Clave API

Se requiere una cuenta de Fireworks AI para crear una clave API.
Ve directamente a la Consola de Fireworks AI para crear una nueva clave API. O sigue estos pasos:
  1. Visita app.fireworks.ai y crea una cuenta o inicia sesión
  2. Una vez dentro, navega a la página de Claves API en la configuración de tu cuenta
  3. Haz clic en el botón “Crear Clave API”
  4. Dale a tu clave un nombre descriptivo (por ejemplo, ‘Kodus’ o cualquier nombre que prefieras)
  5. Haz clic en “Crear” para generar la clave
  6. Copia la clave API de inmediato y guárdala en un lugar seguro — no podrás verla nuevamente
Las cuentas nuevas vienen con $1 en créditos gratuitos para comenzar con tus proyectos.

​
Cómo usar

​
System Requirements

  • Docker (latest stable version)
  • Node.js (latest LTS version)
  • Yarn or NPM (latest stable version)
  • Domain name or fixed IP (for external deployments)
  • 3000: Kodus Web App
  • 3001: API
  • 3332: Webhooks
  • 5672, 15672, 15692: RabbitMQ (AMQP, management, metrics)
  • 3101: MCP Manager (API, metrics)
  • 5432: PostgreSQL - 27017: MongoDB
Internet access is required if you plan to connect to cloud-based Git services (GitHub, GitLab, Bitbucket) or cloud LLM providers (OpenAI, Anthropic, etc.). For self-hosted Git tools and on-prem LLMs within your network, external internet access is optional.

​
Domain Name Setup (Optional)

If you're planning to integrate Kodus with cloud-based Git providers (GitHub, GitLab, or Bitbucket), you'll need public-facing URLs for both the Kodus Web App and its API. This allows your server to receive webhooks for proper Code Review functionality and ensures correct application behavior. We recommend setting up two subdomains:
  • One for the Web Application, e.g., kodus-web.yourdomain.com.
  • One for the API, e.g., kodus-api.yourdomain.com.
Webhooks are handled by a separate service (port 3332). You can either:
  • Use a dedicated webhooks subdomain, e.g., kodus-webhooks.yourdomain.com, or
  • Keep using the API domain and route /github/webhook, /gitlab/webhook, etc. to the webhooks service in your reverse proxy.
Both subdomains should have DNS A records pointing to your server's IP address. Later in this guide, we will configure a reverse proxy (Nginx) to route requests to these subdomains to the correct internal services. This setup is essential for full functionality, including webhooks and authentication.
Note: If you're only connecting to self-hosted Git tools on your network and do not require public access or webhooks, you might be able to use a simpler setup, but this guide focuses on public-facing deployments.

​
Setup

1

Clone the installer repository

git clone https://github.com/kodustech/kodus-installer.git
cd kodus-installer
2

Copy the example environment file

cp .env.example .env
3

Generate secure keys for the required environment variables

./generate-keys.sh
4

Edit the environment file

Edit .env with your values using your preferred text editor.
nano .env
See Environment Variables Configuration for detailed instructions.
5

Run the installer

./scripts/install.sh
6

Success 🎉

When complete, Kodus Services should be running on your machine. You can verify your installation using the following script:
./scripts/doctor.sh
7

Access the web interface

Once you access the web interface for the first time, you'll need to:
  1. Create your admin account - This will be the first user with full system access
  2. Configure your Git provider - Connect GitHub, GitLab, or Bitbucket following the on-screen instructions
  3. Select repositories for analysis - Choose which code repositories Kody will review
For detailed steps on the initial configuration process, refer to our Getting Started Guide.

​
Configurar Fireworks AI en el Archivo de Entorno

Edita tu archivo .env y configura los ajustes principales. Para la Integración de LLM, usa Fireworks AI en Modo Fijo: 
# Configuración principal del sistema (actualiza con tus dominios)
WEB_HOSTNAME_API="kodus-api.yourdomain.com"    
WEB_PORT_API=443                               
NEXTAUTH_URL="https://kodus-web.yourdomain.com"

# Claves de seguridad (genera con los comandos openssl anteriores)
WEB_NEXTAUTH_SECRET="your-generated-secret"
WEB_JWT_SECRET_KEY="your-generated-secret"
API_CRYPTO_KEY="your-generated-hex-key"
API_JWT_SECRET="your-generated-secret"
API_JWT_REFRESHSECRET="your-generated-secret"

# Configuración de la base de datos
API_PG_DB_PASSWORD="your-secure-db-password"
API_MG_DB_PASSWORD="your-secure-db-password"

# Configuración de Fireworks AI (Modo Fijo) 
API_LLM_PROVIDER_MODEL="accounts/fireworks/models/llama4-maverick-instruct-basic"  # Elige tu modelo preferido
API_OPENAI_FORCE_BASE_URL="https://api.fireworks.ai/inference/v1"                  # URL de la API de Fireworks AI  
API_OPEN_AI_API_KEY="your-fireworks-api-key"                                       # Tu clave API de Fireworks AI

# Webhooks del proveedor de Git (elige tu proveedor)
API_GITHUB_CODE_MANAGEMENT_WEBHOOK="https://kodus-api.yourdomain.com/github/webhook"
# o API_GITLAB_CODE_MANAGEMENT_WEBHOOK="https://kodus-api.yourdomain.com/gitlab/webhook"
# o GLOBAL_BITBUCKET_CODE_MANAGEMENT_WEBHOOK="https://kodus-api.yourdomain.com/bitbucket/webhook"
Las URLs de webhook deben alcanzar el servicio de Webhooks (puerto 3332). Usa un dominio dedicado para webhooks o enruta /.../webhook al puerto 3332 en tu proxy inverso.
El Modo Fijo es ideal para Fireworks AI porque proporciona APIs compatibles con OpenAI con velocidades de inferencia ultrarrápidas y acceso a modelos de código abierto de vanguardia sin tiempo de configuración.

​
Run the Installation Script

Looking for more control? Check out our docker-compose file for manual deployment options.
Set the proper permissions for the installation script: 
chmod +x scripts/install.sh
Run the script: 
./scripts/install.sh

​
What the Installer Does

Our installer automates several important steps:
  • Verifies Docker installation
  • Creates networks for Kodus services
  • Clones repositories and configures environment files
  • Runs docker-compose to start all services
  • Executes database migrations
  • Seeds initial data
🎉 Success! When complete, the Kodus Web App and backend services (API, worker, webhooks, MCP manager) should be running on your machine. You can verify your installation by visiting http://localhost:3000 - you should see the Kodus Web Application interface.
Code Review features will not work yet unless you complete the reverse proxy setup. Without this configuration, external Git providers cannot send webhooks to your instance.

​
Configurar Proxy Inverso (Para Producción)

Para webhooks y acceso externo, configura Nginx: 
# Aplicación web (puerto 3000)
server {
    listen 80;
    server_name kodus-web.yourdomain.com;
    location / {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

# API (puerto 3001)  
server {
    listen 80;
    server_name kodus-api.yourdomain.com;
    location ~ ^/(github|gitlab|bitbucket|azure-repos)/webhook {
        proxy_pass http://localhost:3332;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    location / {
        proxy_pass http://localhost:3001;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

​
Verificar la Integración con Fireworks AI

Además de la verificación básica de instalación, confirma que Fireworks AI está funcionando: 
# Verificar específicamente la conexión con la API de Fireworks AI
docker-compose logs api worker | grep -i fireworks
Para información detallada sobre configuración de SSL, monitoreo y configuraciones avanzadas, consulta nuestra guía de despliegue completa.

​
Solución de problemas

  • Verifica que tu clave API sea correcta y esté activa en la Consola de Fireworks AI
  • Comprueba si tienes créditos suficientes en tu cuenta de Fireworks AI
  • Asegúrate de que no haya espacios extra en tu archivo .env
  • Las cuentas nuevas reciben $1 en créditos gratuitos para comenzar
  • Verifica que el nombre del modelo esté correctamente escrito en tu configuración
  • Comprueba que el modelo esté disponible en la biblioteca de modelos actual de Fireworks AI
  • Prueba con un modelo diferente de nuestra lista de recomendados
  • Consulta la documentación de modelos de Fireworks AI
  • Verifica que tu servidor tenga acceso a internet para alcanzar api.fireworks.ai
  • Comprueba si hay restricciones de firewall
  • Revisa los registros de la API/worker para mensajes de error detallados
  • Asegúrate de estar usando el endpoint de API correcto
  • Fireworks AI proporciona velocidades líderes en la industria con latencia mínima
  • Verifica tu conectividad de red para un rendimiento óptimo
  • Considera usar despliegues dedicados para cargas de trabajo empresariales
  • Monitorea tus patrones de uso para optimizar las llamadas a la API
  • Fireworks AI proporciona altos límites de tasa en infraestructura sin servidor
  • Verifica tu uso actual en el panel de Fireworks AI
  • Considera actualizar a despliegues dedicados para mayor rendimiento
  • Contacta al soporte de Fireworks AI para ajustes de límite de tasa empresarial