Novitaの動作方法
NovitaはAI向けのサーバーレスインフラプラットフォームで、低レイテンシとコスト削減でオープンソースモデルをスケールするよう設計されています。Llama、Mistral、Claude、Stable Diffusionなどを含む数百の本番対応モデルをサポートし、DevOpsのオーバーヘッドなしに最適化されたAPI、オンデマンドGPU、カスタムモデルデプロイメントを提供します。推奨モデル
100k以上のコンテキストウィンドウを持つ優れたコーディングモデルを推奨します。より最新の情報については、NovitaのWebサイトをご覧ください。
| モデル | 価格 | コンテキストウィンドウ |
|---|---|---|
Deepseek v3 0324 推奨 | $0.33/1.3 | 約128kトークン |
| Deepseek R1 0528 | $0.7/2.5 | 約128kトークン |
| Llama 4 Maverick Instruct | $0.17/0.85 | 約100kトークン |
APIキーの作成
NovitaのAPIキーページに直接アクセスして新しいAPIキーを作成します。 または、以下の手順に従ってください:- Novitaコンソールに移動します
- “API キーを管理”ボタンをクリックするか、プロフィール画像をクリックしてAPIキーに移動します
- “新しいキーを追加”をクリックして「Kodus」または好きな名前を入力します
- “確認”をクリックします
- APIキーをコピーして安全な場所に保存します
System Requirements
Recommended Hardware
Recommended Hardware
- CPU: 2+ cores - RAM: 8GB+ - Storage: 60GB+ free space
Required Software
Required Software
- Docker (latest stable version)
- Node.js (latest LTS version)
- Yarn or NPM (latest stable version)
- Domain name or fixed IP (for external deployments)
Required Ports
Required Ports
- 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.
- 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.
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
Edit the environment file
Edit See Environment Variables Configuration for detailed instructions.
.env with your values using your preferred text editor.Success 🎉
When complete, Kodus Services should be running on your machine.
You can verify your installation using the following script:
Access the web interface
Once you access the web interface for the first time, you'll need to:
- Create your admin account - This will be the first user with full system access
- Configure your Git provider - Connect GitHub, GitLab, or Bitbucket following the on-screen instructions
- 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.
環境ファイルでNovitaを設定する
.env ファイルを編集してコア設定を構成します。LLMインテグレーションには、Novitaを固定モードで使用します:
WebhookのURLはWebhooksサービス(ポート3332)に到達できる必要があります。専用webhooksドメインを使用するか、リバースプロキシで
/.../webhook をポート3332にルーティングします。固定モードはNovitaに最適です。OpenAI互換のAPIを提供し、必要なAPIキーは1つだけです。これによりセットアップが大幅に簡略化されます。
Run the Installation Script
Set the proper permissions for the installation script: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
http://localhost:3000 - you should see the Kodus Web Application interface.
6. リバースプロキシのセットアップ(本番環境向け)
WebhookとExternal Accessには、Nginxを設定します:Novita統合の確認
基本的なインストール確認に加えて、Novitaが動作していることを確認します:トラブルシューティング
APIキーの問題
APIキーの問題
- APIキーがNovitaコンソールで正しくアクティブであることを確認します
- Novitaアカウントに十分なクレジットがあるか確認します
.envファイルに余分なスペースがないことを確認します
モデルが見つからない
モデルが見つからない
- 設定のモデル名が正しくスペルされていることを確認します
- Novitaプランでモデルが利用可能であることを確認します
- 推奨リストの別のモデルで試してください
接続エラー
接続エラー
- サーバーが
api.novita.aiにアクセスできるインターネット接続を持っていることを確認します - ファイアウォールの制限がないか確認します
- 詳細なエラーメッセージについてAPI/ワーカーログを確認します