Troubleshooting
Encountering an issue? This guide covers common problems and how to solve them.
Installation Issues
"lens" command not found
If you've installed Lens but the lens command isn't recognized:
- Ensure your Python scripts directory is in your system's PATH.
- Run
pip show lensdevto see where it's installed. - Try running it using
python -m lens.cli(if supported).
ModuleNotFoundError
If you see errors about missing modules like click, requests, or rich:
Research Issues
"No results found"
If a research session finishes but the reports are empty or missing expected data:
Your query might be too specific or use terms not recognized by the collectors. Try a broader query. Instead of "The impact of the 2024 tax code on small bakeries in Seattle", try "Small business tax code changes 2024".
Slow Performance
If Lens seems to "hang" or take a very long time:
Usually a slow API response from one of the collectors (often Reddit or ArXiv). Check your internet connection. You can also interrupt the process with Ctrl+C and try a different query.
Collector Failures
If one or more collectors show as failed (red color in progress bar):
Check logs in workspace/[SESSION_ID]/logs/ for the specific collector's error message. Many failures are temporary network blips; simply running the research again often works.
Getting Help
If you can't find the solution here: