Skip to content

Installation

Jump to bottom
Fame edited this page Aug 5, 2026 · 1 revision

Installation

Get started with Savant Code in 30 seconds.

Prerequisites

  • Node.js — v18 or later
  • Ollama (optional) — For local inference, no API key required

Install

npm install -g savant-code

Quick Start

cd your-project
savant-code

Describe the change you want. Savant Code explores the repository, plans the work, implements approved changes, and verifies the result.

Local Inference with Ollama

If Ollama is installed and running, it is detected automatically:

# Install Ollama
curl -fsSL https://ollama.com/install.sh | sh

# Pull a coding model
ollama pull codellama
# or
ollama pull deepseek-coder

# Launch Savant Code
savant-code

Run /health inside the chat to inspect Ollama connectivity, available local models, provider mode, and permission mode.

Hosted Providers

Savant Code supports multiple hosted providers. Use the interactive picker:

/provider

Or configure one directly:

Provider Command Environment Variable
OpenCode Go /provider opencode-go OPENCODE_GO_API_KEY
TokenRouter /provider tokenrouter TOKENROUTER_API_KEY
NVIDIA NIM /provider nvidia NVIDIA_API_KEY
CommandCode /provider commandcode COMMAND_CODE_API_KEY
OpenRouter /provider openrouter OR_MASTER_KEY or OPENROUTER_API_KEY

Configuration

Credentials are stored in the user configuration directory:

  • Windows: C:\Users\<username>\.savant-code\credentials.json
  • macOS/Linux: ~/.savant-code/credentials.json

Shell environment variables take precedence over saved credentials.

First Launch

  1. Install: npm install -g savant-code
  2. Navigate: cd your-project
  3. Launch: savant-code
  4. Configure provider: /provider (or use Ollama automatically)
  5. Start coding: Describe what you want to build

Verification

After installation, verify everything works:

# Check version
savant-code --version

# Check health
# Inside Savant Code, run:
/health

Troubleshooting

Permission Errors

# Use a user-writable installation
npm install -g savant-code

# Or with elevated permissions
sudo npm install -g savant-code

No Model Available

Run /provider to configure a hosted provider, or install and start Ollama for local inference.

Provider Connection Issues

# Check provider status
# Inside Savant Code, run:
/health

Next Steps

Clone this wiki locally