Configuration›Config file

Config file

HezGene stores its configuration in a .hezgene/config.json file in your project root. You can edit it directly or use the CLI.

CLI commands

# View all settings
hezgene config --list

# Set a value
hezgene config --set <key> <value>

# Example: change LLM provider
hezgene config --set llm.provider ollama

Default configuration

{
  "llm": {
    "provider": "ollama",
    "model": "gemma2:2b",
    "api_key": "",
    "base_url": ""
  },
  "evolution": {
    "generations": 5,
    "min_improvement": 0.001,
    "sandbox_dir": ".hezgene/sandbox/"
  },
  "safety": {
    "auto_backup": true,
    "require_verification": true,
    "frozen_functions": []
  }
}

Freezing functions

Critical functions can be permanently protected from evolution:

# Freeze a function
hezgene freeze src/auth.py:verify_password

# Unfreeze
hezgene unfreeze src/auth.py:verify_password

DNA profiles

View the genetic profile of any function:

hezgene dna src/utils.py:calculate_total
‹ Previous
Health Score
How the 0-100 score is computed
LLM Providers
Ollama, OpenAI, Anthropic configs
Next ›