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.
1. Command-Line Options (Recommended for Most Users)
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:
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:
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
- See CLI Options Reference for all configuration flags.
- For provider-specific settings, see the Supported Providers & Models page.
- For troubleshooting, use
janito --help
or consult the Usage Guide.