Installation
No module named 'termios'
No module named 'termios'
switch-trust command, including switch-trust --version, stops at once with ModuleNotFoundError: No module named 'termios'.Cause: You’re running Switch Trust CLI on Windows. The CLI runs on macOS and Linux, and it uses a terminal module that Windows doesn’t have.Fix: Install and run Switch Trust CLI on a macOS or Linux machine. In CI, use a Linux or macOS runner.OpenGrep not found
OpenGrep not found
switch-trust scan warns that the scan is incomplete, and lists opengrep with the reason OpenGrep binary not foundCause: OpenGrep is required for scan functionality but not installed. From version 1.8.0, the scan exits with code 26 after writing its results.Fix: Install OpenGrep using the shell installer:Which API key do I need?
Which API key do I need?
switch-trust scan uses an LLM to analyze your agent code. Run switch-trust init and provide an API key from one of these providers:- Google Gemini - Get your key from aistudio.google.com/apikey (free tier available)
- OpenAI - Get your key from platform.openai.com/api-keys
- Anthropic - Get your key from console.anthropic.com/settings/keys
Unsupported Python version
Unsupported Python version
pip install switch-trust-cli fails with an error that the package requires a different Python version, or with No matching distribution found for datafog==4.4.0.Cause: You’re running a Python version older than 3.11, or 3.14 or later. Switch Trust CLI installs on Python 3.11 to 3.13.Fix:- Install Python 3.11, 3.12 or 3.13 from python.org
- Verify:
python3 --version - Reinstall Switch Trust CLI:
pip install switch-trust-cli
ImportError naming the full extra
ImportError naming the full extra
ImportError such as garak is required for garak probes and detectors. Install it with: pip install switch-trust-cli[full], or the same message for transformers.Cause: Garak probes, toxicity detection, and HuggingFace models rely on machine-learning backends that aren’t part of the standard install. They live in the optional full extra, which keeps the default download roughly 2 GB smaller.Fix: Install the extra. Quote it — in zsh, the default shell on macOS, an unquoted [full] is a glob pattern and the command fails with no matches found:Command not found after install
Command not found after install
switch-trust: command not found after installingCause: Most often, the virtual environment you installed into isn’t active — a new terminal session starts outside it. Less often, you installed outside a virtual environment and the install location isn’t on your PATH.Fix:If you installed in a virtual environment, reactivate it from the directory you created it in:switch-trust.If you installed outside a virtual environment, add the install location to your PATH:- Find where pip installed it:
pip show switch-trust-cli - Add that location to your PATH in
~/.bashrcor~/.zshrc: - Reload:
source ~/.bashrc(or restart terminal)
How do I view Switch Trust CLI logs?
How do I view Switch Trust CLI logs?
switch_trust_<timestamp>.log by default. Use --log to choose the path:Scan
No scannable targets found
No scannable targets found
No scannable targets foundCause: Nothing under the path qualified for scanning. A file is picked up only if it’s a requirements.txt, or a .py file that imports a supported framework — framework imports are what put a file in scope, not just the extension.Fix:- Verify your agent code imports a supported framework
- Check you’re scanning the correct directory
- Make sure files have a
.pyextension.__init__.pyis always skipped, so scanning a package whose only file is__init__.pyfinds nothing
requirements.txt and framework-importing siblings.Framework not detected
Framework not detected
Missing API key: AI reasoning disabled
Missing API key: AI reasoning disabled
switch-trust init to configure your API keyTimeout errors: ADK_LOOP_TIMEOUT_SECS exceeded
Timeout errors: ADK_LOOP_TIMEOUT_SECS exceeded
gemini:gemini-3.1-flash-lite in ~/.switch-trust/.envWhy aren't my files being scanned?
Why aren't my files being scanned?
- Uses Python (not TypeScript/JavaScript)
- Imports at least one supported framework
- Has valid Python syntax
How long does a scan take?
How long does a scan take?
- Codebase size: Number of Python files to analyze
- AI reasoning: GENERATOR_MODEL speed (Gemini Flash is fastest, GPT-4 slowest)
- Findings volume: More potential issues = more LLM calls
- Small agent (1-5 files): 30 seconds - 2 minutes
- Medium project (10-50 files): 2-10 minutes
- Large codebase (100+ files): 10-30 minutes
gemini:gemini-3.1-flash-lite in ~/.switch-trust/.envCan I use Switch Trust CLI in CI/CD?
Can I use Switch Trust CLI in CI/CD?
Eval
Missing config.json
Missing config.json
~/.switch-trust/config.jsonFix: Create a minimal config file at ~/.switch-trust/config.json:Invalid model type
Invalid model type
adk- Google ADK agentsopenai_agent- OpenAI Agents SDKlangchain- LangChain agentscrewai- CrewAI agents
config.json and update the type field.Connection refused: Agent not running
Connection refused: Agent not running
- Start your agent server
- Confirm the server is listening at the
hostfrom your eval config — any HTTP response, even a 404, means it’s reachable, while a connection error means it isn’t running: - Check the
hostfield in your eval config matches the URL of your agent - Ensure there’s no firewall blocking the connection
Empty results: No evaluations attached
Empty results: No evaluations attached
switch-trust eval evaluations list to see what you can attach.Can I add custom evaluations?
Can I add custom evaluations?
config.json:Message collection approach:switch-trust eval model-evaluations attach.See Configuration for more examples.Still stuck? Contact us at support@switchagents.ai

