Skip to content

Configuration Guide

Janito can be configured using command-line options, environment variables, or configuration files. This guide shows you how to set up API keys, select providers and models, and adjust other settings.

Set API keys, providers, and models directly when running Janito:

janito --set-api-key YOUR_API_KEY -p PROVIDER_NAME
janito --set provider=openai
janito -p openai -m gpt-3.5-turbo "Your prompt here"
  • Use -p PROVIDER_NAME to select a provider.
  • Use -m MODEL_NAME to select a model for the provider.
  • See CLI Options for the full list of flags.

2. Using Custom Configuration Files

You can use the -c NAME or --config NAME option to load and save configuration from a custom file:

janito -c myproject "Prompt for my project"

This will use the config file at: - Windows: C:\Users\<YourUser>\.janito\configs\myproject.json - Linux/macOS: /home/<youruser>/.janito/configs/myproject.json

If the file does not exist, it will be created automatically when you save settings.

3. Default Configuration File

By default, Janito uses a config.json file located in the .janito directory under your home folder for persistent settings.

Path:

  • Windows: C:\Users\<YourUser>\.janito\config.json
  • Linux/macOS: /home/<youruser>/.janito/config.json

You can edit this file directly or use Janito CLI commands to update your configuration.

Viewing Effective Configuration

Show the current configuration with:

janito --show-config

This will display the config file path at the top. If you use -c NAME, this will show the configuration for that custom file and its path.

Advanced Configuration

Disabling Tools

You can selectively disable specific tools to customize your workflow or enhance security:

# Disable a single tool
janito --set disabled_tools=ask_user

# Disable multiple tools
janito --set disabled_tools="ask_user,python_code_run"

# View disabled tools
janito --show-config

See the Disabling Tools Guide for complete details.

More Information