Novita AI - Serverless GPU Platform
Learn how to use Novita’s models with Kodus
How Novita works
Novita is a serverless infrastructure platform for AI, designed to scale open-source models with low latency and reduced cost. It supports hundreds of production-ready models — including Llama, Mistral, Claude, and Stable Diffusion — and provides optimized APIs, on-demand GPUs, and custom model deployments without any DevOps overhead.
Recommended Models
We recommend good coding models with +100k context window.
To more updated information, please visit Novita’s website.
Model | Pricing | Context Window |
---|---|---|
Deepseek v3 0324 recommended | $0.33/1.3 | ~128k tokens |
Deepseek R1 0528 | $0.7/2.5 | ~128k tokens |
Llama 4 Maverick Instruct | $0.17/0.85 | ~100k tokens |
Creating API Key
Go directly to Novita’s API Keys page to create a new API Key.
Or, follow these steps:
- Go to your Novita console
- Click on the “Manage API Keys” button or go to your profile picture and click API Keys
- Click on “Add New Key” and fill with ‘Kodus’ or any name you want
- Click on “Confirm”
- Copy the API Key and save it somewhere safe
System Requirements
Internet access is only required if you plan to connect with cloud-based Git services like GitHub, GitLab, or Bitbucket. For self-hosted Git tools 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
.
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.
Get the Kodus Installer
Clone our installer repository:
Configure Environment Variables
First, copy the example environment file:
Generate secure keys for the required environment variables using:
You'll need to generate values for these security keys:
- WEB_NEXTAUTH_SECRET (use openssl rand -base64 32)
- WEB_JWT_SECRET_KEY (use openssl rand -base64 32)
- API_CRYPTO_KEY (use openssl rand -hex 32)
- API_JWT_SECRET (use openssl rand -base64 32)
- API_JWT_REFRESHSECRET (use openssl rand -base64 32)
- CODE_MANAGEMENT_SECRET (use openssl rand -hex 32)
- CODE_MANAGEMENT_WEBHOOK_TOKEN (use openssl rand -base64 32 | tr -d '=' | tr '/+' '_-')
Never commit your .env
file to version control. Keep your API keys and
database credentials secure.
Then update your .env
file with the following required variables:
Configure Novita in Environment File
Edit your .env
file and configure the core settings. For LLM Integration, use Novita in Fixed Mode:
Fixed Mode is ideal for Novita because it provides OpenAI-compatible APIs and requires only one API key. This simplifies your setup significantly.
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:
Run the 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
🎉 Success! When complete, Kodus Orchestrator API and Web Application 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.
6. Set Up Reverse Proxy (For Production)
For webhooks and external access, configure Nginx:
Verify Novita Integration
Além da verificação básica da instalação, confirme que a Novita está funcionando:
For detailed information about SSL setup, monitoring, and advanced configurations, see our complete deployment guide.