Troubleshooting

"Chromium not found"

The application looks for Chromium at /usr/bin/chromium. Install it:

Ubuntu/Debian:

sudo apt-get install chromium-browser

Fedora/RHEL:

sudo dnf install chromium

macOS:

brew install chromium

Windows: Download from chromium.org

"WebGPU must be supported to run"

Your system doesn't support WebGPU hardware acceleration. This usually means:

• No compatible GPU (needs modern NVIDIA, AMD, or Intel graphics)

• Missing GPU drivers

• Running in a VM without GPU passthrough

Solution: Install GPU drivers or use a system with a compatible GPU.

"Missing required environment variables: APIKEY, URL"

You forgot to provide credentials. Either:

• Use flags: -k YOUR_KEY -u http://localhost:3000

• Create a .env file with APIKEY and URL

• Set environment variables: export APIKEY=... URL=...

Connection Issues

If the application can't connect to the server:

1. Check server URL - Ensure it's correct and accessible

2. Verify API key - Log in to the dashboard and confirm your key

3. Network/Firewall - Make sure your system can reach the server

4. Server status - Ensure the ObitCC server is running

High Memory Usage

Chromium uses significant RAM, especially with large models. Recommended:

• Minimum: 4GB RAM

• Recommended: 8GB+ RAM

• For large models: 16GB+ RAM

If memory is constrained, consider closing other applications or using a more powerful machine.

Performance Optimization

For best performance:

1. Enable WebGPU - Requires compatible GPU and drivers. You can see if WebGPU is enabled through the console output, by running the application with the -v flag. You should see a line like WebGPU unavailable, skipping: requestAdapter returned null/timeout if WebGPU is not available.

2. Close unnecessary applications - Free up CPU/GPU resources

3. Use wired connection - More stable than WiFi for network communication

4. Keep system updated - Latest drivers and system updates

5. Monitor temperature - Ensure adequate cooling for sustained workloads