Troubleshooting
Reporting Bugs and Getting Help
How to report issues, generate error reports, and get support
This guide shows you how to report bugs, generate diagnostic information, and get help from the AskUI team.
Before Reporting an Issue
1. Gather System Information
Save this output - support will need it.
2. Check Existing Resources
- Review relevant troubleshooting guides
- Search our Discord community for similar issues
- Check release notes for known issues
3. Document the Problem
Prepare these details:
- Steps to reproduce the issue
- Expected behavior vs actual behavior
- Error messages (exact text or screenshots)
- Your code snippet that triggers the issue
Generating Error Reports
Automatic Error Report
The fastest way to collect diagnostic information:
- Open Terminal/PowerShell
- Enter
askui-shell
- Import experimental commands:
- Generate the report:
Error Report Process
When you run AskUI-NewErrorReport
:
What’s Included in Error Reports
- System information and versions
- AskUI configuration (workspace ID only, no tokens)
- Recent logs from AskUI processes
- Error stack traces
- Environment details
Your access tokens and sensitive data are NOT included in error reports.
Manual Diagnostic Collection
If automatic reporting fails, collect manually:
1. System Information
2. Python Environment
3. Screenshot of Issue
4. Debug Logs
Contacting Support
Email Support
Send reports to: support@askui.com
Include:
- Error report ZIP file (from
AskUI-NewErrorReport
) - Description of the issue
- Impact on your work
- Any workarounds you’ve tried
Discord Community
Join our Discord server:
- Post in
#support
channel - Share error reports and screenshots
- Get help from community and AskUI team
GitHub Issues
For confirmed bugs:
- Visit AskUI GitHub
- Check existing issues first
- Create new issue with:
- Clear title
- Reproduction steps
- Environment details
- Error messages
Response Times
- Email: 24-48 business hours
- Discord: Community responses often within hours
- Critical Issues: Mark as “URGENT” in email subject
Providing Feedback
Feature Requests
Send ideas to: feedback@askui.com
Include:
- Use case description
- Current workaround (if any)
- Expected benefit
Documentation Improvements
Found an error or unclear section?
- Email specific page and issue
- Suggest improvements
- Share what confused you
Common Support Scenarios
”It works on my machine but not in CI/CD”
Provide:
- Local environment details (from
AskUI-ShowVersions
) - CI/CD environment details
- Differences in configuration
- CI/CD logs
”Element not found” Issues
Include:
- Screenshot from
agent.save_screenshot()
- Your selector code
- HTML/UI framework being automated
Performance Problems
Share:
- Time measurements
- System resources (CPU, RAM)
- Number of agents running
- Size of UI being automated
Self-Service Resources
Before contacting support, try:
- Documentation Search: Use search feature in docs
- Discord History: Search previous discussions
- YouTube Tutorials: Check AskUI YouTube
- Blog Posts: Visit blog.askui.com
Enterprise Support
Enterprise customers have additional options:
- Dedicated support channel
- Priority response times
- Direct access to engineering team
- Custom training sessions
Contact your account manager for details.
Next Steps
- Back to Troubleshooting Overview
- Review Common Issues
- Check FAQ