LLM and API keys
| Issue | Fix |
|---|---|
Could not generate an answer / 401 | Check API keys; arka ai-models; set AI_PREFERRED_PROVIDER=groq; arka ai reset-exhaustion |
| Gemini 429 / slow responses | Orchestrator auto-fails over with LLM_AUTO_FALLBACK=1; prefer Groq via AI_PREFERRED_PROVIDER=groq |
| Wrong model picked | arka ai-skill-model web_answer groq/llama-3.3-70b-versatile |
Routing
| Issue | Fix |
|---|---|
uv pip install am on random text | Use arka, not raw shell, for NL |
| Plain text command does nothing | Prefix it with arka or use agent_route so Arka can intercept it |
| Plugin not routing | arka skills refresh; check skill.json triggers; arka route "your trigger phrase" |
| Config changes not picked up | arka reload or new shell; arka reload --listen for wake listener |
PDF RAG
| Issue | Fix |
|---|---|
| PDF ask fails | arka pdf status; ensure Qdrant Docker is up |
Web search
| Issue | Fix |
|---|---|
| Deep search empty | pip install ddgs trafilatura beautifulsoup4 |
| Map download timeout | Retry map_download <city> later (Overpass API) |
Voice
| Issue | Fix |
|---|---|
| Wake word missed / wrong STT | Set ASSEMBLYAI_API_KEY; or SARVAM_API_KEY + SARVAM_STT_MODE=translit |
| Devanagari breaks routing | Fixed via arka_stt_map.py; try LISTEN_STT_LANG=en-IN |
| Listener crashes | arka wake --check then arka doctor |
| Wrong microphone | Linux: pactl list sources short → set MIC_DEVICE in .env |
Charts
| Issue | Fix |
|---|---|
| Chart defaults not applied | Edit ~/.config/arka/charts.yaml; set CHARTS_CONFIG for custom path |
| Fetch-style chart NL not routing | Use inline label:value pairs; external fetch wiring in progress |
Observability
| Issue | Fix |
|---|---|
| SigNoz traces not appearing | Set OTEL_TRACES_ENABLED=1 (not just SIGNOZ_ENDPOINT); arka signoz status |
Memory
| Issue | Fix |
|---|---|
| Supermemory not used | arka supermemory status; set SUPERMEMORY_API_KEY; MEMORY=auto |
Logs
~/.cache/arka/*.log
~/.cache/fish-agent/*.log # legacy fish installs