Skip to content

Troubleshooting

Common issues and their solutions when using PADAI.

Installation Issues

PadaiPanel won't launch: ".NET Desktop Runtime missing"

Cause: The .NET 10 Desktop Runtime is not installed on your machine.

Solution: Download and install the .NET 10 Desktop Runtime from the official Microsoft website. PadaiPanel requires the Desktop variant, not just the base runtime.

Server returns "Connection refused" on port 8000

Cause: The PADAI backend is not running or the port is blocked.

Solution:

  1. Verify the server is running: docker compose ps (Docker) or check the Python process
  2. Check firewall rules allow inbound connections on port 8000
  3. Verify no other service is using port 8000
  4. Check the server logs for startup errors

Docker image fails to load

Cause: Corrupt or incomplete download of padai-api.tar.

Solution:

  1. Verify the file size matches the expected size
  2. Re-download the Docker image archive
  3. Run docker load -i padai-api.tar and check for error messages

Connection Issues

PadaiPanel shows "Disconnected"

Cause: The panel cannot reach the PADAI backend server.

Solution:

  1. Check the server URL in PadaiPanel Settings
  2. Verify the server is running and healthy: curl http://server:8000/api/healthz
  3. Check your network connection and proxy settings
  4. Ensure the API token in PadaiPanel matches the server's API_TOKEN

HTTP 401 Unauthorized

Cause: The API token is incorrect.

Solution: Verify that the API_TOKEN in the server .env file matches the token configured in PadaiPanel settings.

HTTP 402 Payment Required

Cause: The license has expired or the monthly run quota has been exceeded.

Solution:

  1. Check license status: GET /api/license/status
  2. If expired: contact PADAI Technologies for a renewed license.json
  3. If quota exceeded: wait for the next billing cycle or upgrade your plan

HTTP 429 Too Many Requests

Cause: You have exceeded the rate limit.

Solution: Wait a few seconds and retry. If this happens frequently, ask your IT administrator to increase RATE_LIMIT_PER_MIN in the server configuration.

Panel Issues

PadaiPanel doesn't dock to PAD Designer

Cause: The PAD Designer window is not detected.

Solution:

  1. Make sure a flow is open in the PAD Designer (not just the PAD home screen)
  2. Close and relaunch PadaiPanel
  3. If multiple monitors are in use, ensure both PAD and PadaiPanel are on the same monitor

Context is empty after refresh

Cause: No flow is open in PAD, or the Designer is in a state that prevents UI Automation reading.

Solution:

  1. Open a flow in the PAD Designer
  2. Make sure the Designer is the active window (not minimized)
  3. Click Refresh Context again
  4. If the issue persists, close and reopen the flow in PAD

Applied code doesn't appear in PAD

Cause: The UI Automation write to the Designer failed.

Solution:

  1. Verify the correct subflow is active in the PAD Designer
  2. Make sure the Designer is not in a modal dialog state
  3. Try clicking in the Designer code area first, then use the Apply button
  4. As a fallback, use the Copy button and paste manually into PAD (Ctrl+V)

Flowchart diagram doesn't display

Cause: Microsoft Edge WebView2 Runtime is not installed.

Solution: Install the Microsoft Edge WebView2 Runtime from the official Microsoft website. PadaiPanel uses WebView2 to render Mermaid diagrams.

Voice dictation doesn't work

Cause: Microphone not authorized or Whisper configuration missing.

Solution:

  1. Check Windows microphone permissions (Settings > Privacy > Microphone)
  2. Verify the OpenAI API key on the server supports Whisper
  3. Check that the server has outbound access to the OpenAI API

AI and Code Generation Issues

OpenAI/Azure OpenAI errors

Cause: Invalid API key, quota exceeded, or connectivity issue.

Solution:

  1. Verify your API key is correct in the server .env
  2. Check your OpenAI/Azure OpenAI account for quota or billing issues
  3. Verify the server has outbound connectivity to api.openai.com or your Azure OpenAI endpoint
  4. Check server logs for detailed error messages

Generated code has errors when applied to PAD

Cause: The generated Robin code may not be compatible with your specific PAD version, or the flow context was outdated.

Solution:

  1. Refresh the context before generating code
  2. Use the Fix Errors quick fix button
  3. Check that you are using a supported version of Power Automate Desktop
  4. Try being more specific in your prompt about the expected behavior

Slow response times

Cause: The AI model is processing a complex request, or there is network latency to the AI provider.

Solution:

  1. Complex prompts with large code context take longer -- this is normal
  2. Check your network connection to the AI provider
  3. Consider using a faster AI model if available (e.g., GPT-4o instead of GPT-4)
  4. Check server resource usage (CPU, memory)

Diagnostic Tools

Panel Logs

PadaiPanel writes detailed logs to %LOCALAPPDATA%\PadaiPanel\logs\. Include these logs when contacting support.

Diagnostics Panel

Access the Diagnostics panel from PadaiPanel Settings. It shows real-time internal events: server requests, UI Automation reads, and errors.

Server Logs

Check Docker logs (docker compose logs -f) or the Python console output for backend errors.

Reset Configuration

If PadaiPanel won't start correctly, delete the %LOCALAPPDATA%\PadaiPanel\ folder to reset all settings. The onboarding wizard will appear at the next launch.

Getting Help

If your issue is not listed here:

  1. Check the full User Guide
  2. Email support@padai.tech with:
  3. Your PADAI version (from Settings or /api/version)
  4. Steps to reproduce the issue
  5. Relevant screenshots or log files
  6. Your Windows and PAD versions