Skip to content

Troubleshooting

Terminal window
python --version
python -m pip show swarms
SymptomFirst place to look
Command unavailableInstall and PATH.
Auth failsProvider key and model name.
Tool failsTest the tool alone.
Output is noisyInspect intermediate output and context.

Start with the smallest failing layer. Installation, provider auth, model call, tool execution, workflow synthesis, and deployment all fail differently.

Terminal window
python --version
python -m pip show swarms
python - <<'PY'
from swarms import Agent
print(Agent)
PY
SymptomFirst place to look
Command or import failsInstall path, virtual environment, and package.
Auth failsProvider key, model name, and account.
Tool failsRun the tool outside the agent.
Output is noisyInspect prompt, context, intermediate outputs, and loop limits.
Deployment differs from localEnvironment variables, network access, and runtime version.