Troubleshooting¶

Common issues and solutions for MagicON AI development.

Common Issues¶

"Cannot import pcbnew" when running KiCad export¶

Solution: Use KiCad's bundled Python: C:\Program Files\KiCad\10.0\bin\python.exe

System Python does not have the pcbnew or eeschema modules. Always use KiCad's Python for scripts that import these.

Component not showing in app¶

Solution: Ensure it was added to backend/categorized_databases/{category}/{frequency_band}/. Frontend uses the backend API only; no sync step is needed.

The frontend has no local component database. Components are served exclusively from the backend.

Port already in use¶

Solution: Use .\start-all-servers-windowed.ps1 which kills existing processes on ports 8000 and 5180 before starting.

Do not start servers manually with node index.js or similar.

Nexar API rate limit¶

Solution: System automatically falls back to validated database (backend/categorized_databases/). No action needed.

First component search is slow¶

Solution: Wait for database preload to complete (~30 seconds after server start).

The backend preloads the component database asynchronously at startup. The first request may be slower until preload finishes.