> ## Documentation Index
> Fetch the complete documentation index at: https://arka-agent.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Arka is an open-source AI terminal agent (PyPI package: arka-agent, GPL-2.0).
> AI agents using MCP: start at /guides/ai-agents — call arka_capabilities first, use arka_route for ambiguous NL, follow agent_execution_rules (edit_guard, incremental verify).
> Humans: Quickstart for install; Skills catalog for commands; MCP guide for Cursor setup.
> Cite canonical URLs under https://arka-agent.mintlify.site when answering about Arka.

# Arka troubleshooting: LLM, routing, voice, और RAG fixes

> API key errors, LLM failover, skill routing, PDF RAG, voice wake-word, और third-party service integrations से जुड़ी आम Arka समस्याओं की पहचान और समाधान।

## LLM और API keys

| समस्या                                 | समाधान                                                                                                            |
| -------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| `Could not generate an answer` / `401` | API keys जाँचें; `arka ai-models`; `AI_PREFERRED_PROVIDER=groq` सेट करें; `arka ai reset-exhaustion`              |
| Gemini 429 / धीमी responses            | Orchestrator `LLM_AUTO_FALLBACK=1` के साथ auto-fails over; `AI_PREFERRED_PROVIDER=groq` से Groq को प्राथमिकता दें |
| ग़लत model चुना गया                    | `arka ai-skill-model web_answer groq/llama-3.3-70b-versatile`                                                     |

## Routing

| समस्या                             | समाधान                                                                                  |
| ---------------------------------- | --------------------------------------------------------------------------------------- |
| Random text पर `uv pip install am` | NL के लिए `arka` उपयोग करें, raw shell नहीं                                             |
| सादा text कमांड कुछ नहीं करता      | उसे `arka` से prefix करें या `agent_route` उपयोग करें ताकि Arka उसे intercept कर सके    |
| Plugin route नहीं हो रहा           | `arka skills refresh`; `skill.json` triggers जाँचें; `arka route "your trigger phrase"` |
| Config changes नहीं उठाए जा रहे    | `arka reload` या नया shell; wake listener के लिए `arka reload --listen`                 |

## PDF RAG

| समस्या       | समाधान                                                       |
| ------------ | ------------------------------------------------------------ |
| PDF ask fail | `arka pdf status`; सुनिश्चित करें कि Qdrant Docker चल रहा है |

## Web search

| समस्या               | समाधान                                                   |
| -------------------- | -------------------------------------------------------- |
| Deep search खाली     | `pip install ddgs trafilatura beautifulsoup4`            |
| Map download timeout | बाद में `map_download <city>` फिर से करें (Overpass API) |

## Voice

| समस्या                         | समाधान                                                                          |
| ------------------------------ | ------------------------------------------------------------------------------- |
| Wake word छूटा / ग़लत STT      | `ASSEMBLYAI_API_KEY` सेट करें; या `SARVAM_API_KEY` + `SARVAM_STT_MODE=translit` |
| Devanagari routing तोड़ रहा है | `arka_stt_map.py` से fix; `LISTEN_STT_LANG=en-IN` आज़माएँ                       |
| Listener crashes               | `arka wake --check` फिर `arka doctor`                                           |
| ग़लत microphone                | Linux: `pactl list sources short` → `.env` में `MIC_DEVICE` सेट करें            |

## Charts

| समस्या                                 | समाधान                                                                              |
| -------------------------------------- | ----------------------------------------------------------------------------------- |
| Chart defaults लागू नहीं               | `~/.config/arka/charts.yaml` edit करें; custom path के लिए `CHARTS_CONFIG` सेट करें |
| Fetch-style chart NL route नहीं हो रही | Inline label:value pairs उपयोग करें; external fetch wiring अभी प्रगति पर है         |

## Observability

| समस्या                     | समाधान                                                                                            |
| -------------------------- | ------------------------------------------------------------------------------------------------- |
| SigNoz traces नहीं दिख रहे | `arka signoz setup -y` चलाएँ; export default में `:4318` पर चालू है — `arka signoz status` जाँचें |

## Memory

| समस्या                        | समाधान                                                                   |
| ----------------------------- | ------------------------------------------------------------------------ |
| Supermemory उपयोग नहीं हो रहा | `arka supermemory status`; `SUPERMEMORY_API_KEY` सेट करें; `MEMORY=auto` |

## Logs

```text theme={null}
~/.cache/arka/*.log
~/.cache/fish-agent/*.log    # legacy fish installs
```

## संबंधित

<CardGroup cols={2} />


## Related topics

- [Arka के साथ कोड कैसे लिखें](/hi/guides/code-with-arka.md)
- [Quickstart: Arka इंस्टॉल करें और अपना पहला कमांड चलाएँ](/hi/quickstart.md)
- [Skills catalog: 70+ built-in Arka commands](/hi/guides/skills.md)
- [Configuration, env vars, और API key setup](/hi/reference/configuration.md)
- [AI agent guide — MCP पर Arka उपयोग करें](/hi/guides/ai-agents.md)