メインコンテンツへスキップ

​
Fireworks AIの動作方法

Fireworks AIは生成AIアプリケーションを秒単位で構築・実行するよう設計された最速の推論プラットフォームです。DeepSeek、Llama、Qwen、Mistralなどの人気オープンソースモデルへのサーバーレスアクセスを最適化されたスピード、高スループット、最小レイテンシで提供します。GPU管理の複雑さなしに信頼性が高く超高速なAIインフラが必要な開発者のために構築されています。

​
推奨モデル

競争力のある価格と高いコンテキストウィンドウを持つ優れたコーディングモデルを推奨します。
最新情報については、Fireworks AIの価格ページを参照してください。
モデル価格（トークン100万当たり）コンテキストウィンドウ
Llama 4 Maverick 推奨0.22/0.22/0.88約131kトークン
Llama 4 Scout0.15/0.15/0.60約131kトークン
DeepSeek V3$0.90約128kトークン
Qwen3 235B0.22/0.22/0.88約131kトークン

​
APIキーの作成

APIキーを作成するにはFireworks AIアカウントが必要です。
Fireworks AIコンソールに直接アクセスして新しいAPIキーを作成します。 または、以下の手順に従ってください：
  1. app.fireworks.aiにアクセスしてアカウントを作成するかサインインします
  2. ログイン後、アカウント設定のAPIキーページに移動します
  3. **「APIキーを作成」**ボタンをクリックします
  4. キーに説明的な名前を付けます（例：「Kodus」または好きな名前）
  5. **「作成」**をクリックしてキーを生成します
  6. APIキーをすぐにコピーして安全な場所に保存します — 再度見ることはできません
新しいアカウントにはプロジェクトを始めるための$1の無料クレジットが付きます。

​
使用方法

​
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.

​
環境ファイルでFireworks AIを設定する

.env ファイルを編集してコア設定を構成します。LLMインテグレーションには、Fireworks AIを固定モードで使用します： 
# コアシステム設定（ドメインを更新）
WEB_HOSTNAME_API="kodus-api.yourdomain.com"    
WEB_PORT_API=443                               
NEXTAUTH_URL="https://kodus-web.yourdomain.com"

# セキュリティキー（上記のopensslコマンドで生成）
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"

# データベース設定
API_PG_DB_PASSWORD="your-secure-db-password"
API_MG_DB_PASSWORD="your-secure-db-password"

# Fireworks AI設定（固定モード） 
API_LLM_PROVIDER_MODEL="accounts/fireworks/models/llama4-maverick-instruct-basic"  # 好みのモデルを選択
API_OPENAI_FORCE_BASE_URL="https://api.fireworks.ai/inference/v1"                  # Fireworks AI API URL  
API_OPEN_AI_API_KEY="your-fireworks-api-key"                                       # Fireworks AI APIキー

# Gitプロバイダーのwebhook（プロバイダーを選択）
API_GITHUB_CODE_MANAGEMENT_WEBHOOK="https://kodus-api.yourdomain.com/github/webhook"
# または API_GITLAB_CODE_MANAGEMENT_WEBHOOK="https://kodus-api.yourdomain.com/gitlab/webhook"
# または GLOBAL_BITBUCKET_CODE_MANAGEMENT_WEBHOOK="https://kodus-api.yourdomain.com/bitbucket/webhook"
WebhookのURLはWebhooksサービス（ポート3332）に到達できる必要があります。専用webhooksドメインを使用するか、リバースプロキシで /.../webhook をポート3332にルーティングします。
固定モードはFireworks AIに最適です。超高速の推論スピードとセットアップ時間ゼロで最先端のオープンソースモデルへのアクセスを持つOpenAI互換APIを提供します。

​
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.

​
リバースプロキシのセットアップ（本番環境向け）

WebhookとExternal Accessには、Nginxを設定します： 
# Webアプリ（ポート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（ポート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;
    }
}

​
Fireworks AI統合の確認

基本的なインストール確認に加えて、Fireworks AIが動作していることを確認します： 
# Fireworks AI API接続を具体的に確認
docker-compose logs api worker | grep -i fireworks
SSLセットアップ、モニタリング、高度な設定の詳細については、完全なデプロイガイドを参照してください。

​
トラブルシューティング

  • APIキーがFireworks AIコンソールで正しくアクティブであることを確認します
  • Fireworks AIアカウントに十分なクレジットがあるか確認します
  • .env ファイルに余分なスペースがないことを確認します
  • 新しいアカウントには$1の無料クレジットが付いて始められます
  • 設定のモデル名が正しくスペルされていることを確認します
  • Fireworks AIのCurrentモデルライブラリでモデルが利用可能であることを確認します
  • 推奨リストの別のモデルで試してください
  • Fireworks AIモデルドキュメントを確認します
  • サーバーが api.fireworks.ai にアクセスできるインターネット接続を持っていることを確認します
  • ファイアウォールの制限がないか確認します
  • 詳細なエラーメッセージについてAPI/ワーカーログを確認します
  • 正しいAPIエンドポイントを使用していることを確認します
  • Fireworks AIは業界をリードするスピードと最小レイテンシを提供します
  • 最適なパフォーマンスのためにネットワーク接続を確認します
  • エンタープライズワークロードには専用デプロイメントの使用を検討します
  • API呼び出しを最適化するために使用パターンを監視します
  • Fireworks AIはサーバーレスインフラで高いレート制限を提供します
  • Fireworks AIダッシュボードで現在の使用量を確認します
  • より高いスループットのために専用デプロイメントへのアップグレードを検討します
  • エンタープライズのレート制限調整にはFireworks AIサポートに連絡します