Pular para o conteúdo principal

​
Como o Fireworks AI funciona

O Fireworks AI é a plataforma de inferência mais rápida para IA generativa, projetada para criar e executar aplicações de IA em segundos. A plataforma fornece acesso serverless a modelos open-source populares como DeepSeek, Llama, Qwen e Mistral com velocidade otimizada, alto throughput e latência mínima. Desenvolvido para desenvolvedores que precisam de uma infraestrutura de IA confiável e extremamente rápida sem a complexidade de gerenciar GPUs.

​
Modelos Recomendados

Recomendamos bons modelos de codificação com preços competitivos e janelas de contexto grandes.
Para as informações mais atualizadas, visite a página de preços do Fireworks AI.
ModeloPreço (1M tokens)Janela 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

​
Criando uma Chave de API

Uma conta Fireworks AI é necessária para criar uma Chave de API.
Acesse diretamente o Console Fireworks AI para criar uma nova Chave de API. Ou siga estes passos:
  1. Visite app.fireworks.ai e crie uma conta ou faça login
  2. Após fazer login, navegue até a página de Chaves de API nas configurações da sua conta
  3. Clique no botão “Criar Chave de API”
  4. Dê um nome descritivo à sua chave (ex.: ‘Kodus’ ou qualquer nome que preferir)
  5. Clique em “Criar” para gerar a chave
  6. Copie a chave de API imediatamente e guarde-a em um lugar seguro - você não poderá vê-la novamente
Novas contas recebem $1 em créditos gratuitos para começar com seus projetos.

​
Como 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 o Fireworks AI no Arquivo de Ambiente

Edite o seu arquivo .env e configure as definições principais. Para a Integração de LLM, use o Fireworks AI no Modo Fixo: 
# Configurações Principais do Sistema (atualize com seus domínios)
WEB_HOSTNAME_API="kodus-api.yourdomain.com"    
WEB_PORT_API=443                               
NEXTAUTH_URL="https://kodus-web.yourdomain.com"

# Chaves de Segurança (gere com os comandos openssl acima)
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"

# Configuração do Banco de Dados
API_PG_DB_PASSWORD="your-secure-db-password"
API_MG_DB_PASSWORD="your-secure-db-password"

# Configuração Fireworks AI (Modo Fixo) 
API_LLM_PROVIDER_MODEL="accounts/fireworks/models/llama4-maverick-instruct-basic"  # Escolha seu modelo preferido
API_OPENAI_FORCE_BASE_URL="https://api.fireworks.ai/inference/v1"                  # URL da API Fireworks AI  
API_OPEN_AI_API_KEY="your-fireworks-api-key"                                       # Sua Chave de API Fireworks AI

# Webhooks do Provedor Git (escolha seu provedor)
API_GITHUB_CODE_MANAGEMENT_WEBHOOK="https://kodus-api.yourdomain.com/github/webhook"
# ou API_GITLAB_CODE_MANAGEMENT_WEBHOOK="https://kodus-api.yourdomain.com/gitlab/webhook"
# ou GLOBAL_BITBUCKET_CODE_MANAGEMENT_WEBHOOK="https://kodus-api.yourdomain.com/bitbucket/webhook"
As URLs de webhook devem alcançar o serviço de Webhooks (porta 3332). Use um domínio dedicado para webhooks ou roteie /.../webhook para a porta 3332 no seu proxy reverso.
O Modo Fixo é ideal para o Fireworks AI porque ele fornece APIs compatíveis com OpenAI com velocidades de inferência extremamente rápidas e acesso a modelos open-source de ponta sem tempo de configuração.

​
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 Reverso (Para Produção)

Para webhooks e acesso externo, configure o Nginx: 
# Aplicação Web (porta 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 (porta 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 a Integração com o Fireworks AI

Além da verificação básica de instalação, confirme que o Fireworks AI está funcionando: 
# Verificar especificamente a conexão com a API Fireworks AI
docker-compose logs api worker | grep -i fireworks
Para informações detalhadas sobre configuração de SSL, monitoramento e configurações avançadas, consulte nosso guia completo de implantação.

​
Solução de problemas

  • Verifique se sua chave de API está correta e ativa no Console Fireworks AI
  • Verifique se você tem créditos suficientes na sua conta Fireworks AI
  • Certifique-se de que não há espaços extras no seu arquivo .env
  • Novas contas recebem $1 em créditos gratuitos para começar
  • Verifique se o nome do modelo está escrito corretamente na sua configuração
  • Verifique se o modelo está disponível na biblioteca de modelos atual do Fireworks AI
  • Tente com um modelo diferente da nossa lista recomendada
  • Consulte a documentação de modelos do Fireworks AI
  • Verifique se o seu servidor tem acesso à internet para alcançar api.fireworks.ai
  • Verifique se há restrições de firewall
  • Revise os logs da API/worker para mensagens de erro detalhadas
  • Certifique-se de que está usando o endpoint de API correto
  • O Fireworks AI fornece velocidades líderes do setor com latência mínima
  • Verifique sua conectividade de rede para desempenho ideal
  • Considere usar implantações dedicadas para cargas de trabalho empresariais
  • Monitore seus padrões de uso para otimizar as chamadas de API
  • O Fireworks AI fornece limites de taxa altos em infraestrutura serverless
  • Verifique seu uso atual no painel do Fireworks AI
  • Considere fazer upgrade para implantações dedicadas para maior throughput
  • Entre em contato com o suporte do Fireworks AI para ajustes de limite de taxa empresarial