Installation Errors
Windows Long Path Support
Some Windows systems have issues with long file paths during installation. Solution:- Open
askui-shell
as Administrator - Run:
AskUI-EnableLongPath
- Restart your system
- Try the installation again
IDE Integration
VSCode Custom Terminal Setup
To useaskui-shell
as your default terminal in VSCode:
- Open VS Code Settings (Ctrl+,)
- Click “Open Settings (JSON)” icon
- Add this configuration:
PyCharm Terminal Setup
- Go to Settings > Tools > Terminal
- Set Shell path to:
- Windows:
%ASKUI_INSTALLATION_DIRECTORY%\\Tools\\askui-shell.cmd
- macOS:
$ASKUI_INSTALLATION_DIRECTORY/Tools/askui-shell
- linux:
$ASKUI_INSTALLATION_DIRECTORY/Tools/askui-shell
- Windows:
- Apply and restart PyCharm
Environment Configuration
Using .env Files Instead of askui-shell
If you prefer not to use askui-shell, you can configure credentials via environment files:- Install python-dotenv:
- Create
.env
file in your project root:
- Load in your Python script:
Need tokens? See Create Access Tokens
Python Environment Issues
Virtual Environment Setup
Always use a virtual environment to avoid conflicts:Managing Multiple Python Versions
Use askui-shell to manage Python environments:Network Connectivity Check
After installation, verify everything works:- Open askui-shell
- Run:
AskUI-TestConnection
- Check versions:
AskUI-ShowVersions
Common Installation Locations
- Windows:
%APPDATA%\askui GmbH\AskUI Suite\.askui-suite
- macOS:
/Applications/.askui-suite
- Linux:
/opt/askui
or/usr/local/bin/askui-shell
Next Steps
- Installation successful? Start with our Quickstart Guide
- Having network issues? See Network and Connectivity
- Need help? Report an issue