Troubleshooting
Current Known Issues
Active issues and limitations in AskUI products
This page lists currently known issues and limitations in AskUI products. We update this list as issues are resolved or new ones are discovered.
For solutions to common problems, see our Troubleshooting Guides.
AskUI Suite
Platform Limitations
PxProxy - Windows Only
- Affected Versions: All current versions
- Description: PxProxy is available only for Windows AMD64 architecture
- Impact: Users on macOS, Linux, or ARM architectures cannot use the local proxy feature
- Workaround: Use alternative proxy solutions on non-Windows platforms
TypeScript Project Limitation
- Affected Commands:
AskUI-NewProject,AskUI-RunProject - Description: These commands only support TypeScript projects
- Impact: Python projects must be created and managed manually
- Workaround: Use Python SDK directly with manual project setup
Performance Issues
ADE Slower Startup Time
- Affected Versions: 25.2.1 and later
- Description: AskUI Development Environment (ADE) startup is slower than previous versions
- Impact: Initial startup may take 10-30 seconds longer
- Workaround: Keep ADE running to avoid repeated startup delays
Windows-Specific Issues
Long Path Problems
- Affected Versions: All Windows installations
- Description: Windows users may encounter issues with paths exceeding 260 characters
- Impact: Installation or file operations may fail
- Solution:
Then restart your system.
Python Vision Agent
Session Management
- Issue: “Session info doesn’t match” errors
- Cause: Controller session mismatch
- Solution: See Runtime Errors Guide
Multi-Monitor Limitations
- Issue: Limited support for systems with 3+ monitors
- Impact: May not detect elements on monitors beyond the second
- Workaround: Specify display parameter explicitly
Model Limitations
OCR Accuracy
- Issue: Certain fonts or backgrounds reduce text recognition accuracy
- Affected: Decorative fonts, low contrast text, complex backgrounds
- Solution: See OCR Troubleshooting
Dynamic Content
- Issue: Rapidly changing content may not be captured accurately
- Impact: Animations or live data might be missed
- Workaround: Add delays or wait for stable state
Browser Compatibility
Chrome Extensions
- Issue: Some Chrome extensions interfere with element detection
- Affected Extensions: Ad blockers, dark mode extensions
- Workaround: Disable extensions during automation
Safari on macOS
- Issue: Limited accessibility permissions
- Impact: Some elements may not be detectable
- Solution: Grant full accessibility permissions in System Preferences
Enterprise Features
Proxy Authentication
- Issue: NTLM/Kerberos proxy authentication requires additional setup
- Impact: Direct connection through corporate proxies may fail
- Solution: See Network Configuration
Air-Gapped Environments
- Issue: Offline installation requires manual dependency management
- Impact: Standard installation procedures don’t work
- Contact: Enterprise support for offline installation packages
Mobile Testing
iOS Simulator
- Issue: Text selection in iOS Simulator is unreliable
- Affected Versions: iOS 15+
- Workaround: Use real devices for text-heavy automation
Android Emulator
- Issue: GPU acceleration conflicts on some systems
- Impact: Visual detection may be slow or inaccurate
- Solution: Disable GPU acceleration in emulator settings
Reporting New Issues
Found an issue not listed here? Please:
- Check our FAQ first
- Search Discord for similar reports
- Report the issue with details
Issue Resolution Status
We track issue resolution in our:
- Release Notes - For resolved issues
- Roadmap - For planned fixes
- Status Page - For service-related issues
This page is updated regularly. Last update: Check the git history for the most recent changes.