> ## 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.

# Free AI credits का अधिकतम उपयोग

> शून्य- या कम-लागत Arka उपयोग के लिए Gemini, Groq, OpenRouter, और Ollama सेट करें — failover, key rotation, और token-saving routing के साथ।

Arka में नए हैं? Free LLM quotas को बढ़ाने और जहाँ हो सके स्थानीय रूप से चलाने के लिए यहाँ से शुरू करें।

अगर आप कहते हैं `arka free tier setup`, तो Arka को इसे `free_credits` पर route करना चाहिए, न कि generic `web_answer` पर।

## प्राकृतिक भाषा

```bash theme={null}
arka how to get free ai credits
arka maximize free credits
arka free tier setup
arka how to use arka without paying
arka learn free ai providers
```

## CLI

```bash theme={null}
arka free_credits
```

आपके configured providers, अनुशंसित `.env` settings, और verification steps दिखाता है।

## Free providers (अनुशंसित stack)

| Provider       | Cost               | Key कहाँ लें                                                 |
| -------------- | ------------------ | ------------------------------------------------------------ |
| **Gemini**     | Free tier          | [Google AI Studio](https://aistudio.google.com/apikey)       |
| **Groq**       | Free tier          | [Groq Console](https://console.groq.com/keys)                |
| **OpenRouter** | Free + paid models | [OpenRouter](https://openrouter.ai/keys)                     |
| **Ollama**     | Local — \$0 API    | [ollama.com](https://ollama.com) + `ollama pull llama3.2:1b` |

Arka का default failover chain अन्य configured providers से पहले **Gemini Flash → Groq Llama → Ollama** आज़माता है।

## चरण-दर-चरण

### 1. Keys को `.env` में जोड़ें

`~/.config/arka/.env` को edit करें (जो `arka setup` से बनी है):

```env theme={null}
GEMINI_API_KEY=your_key
GROQ_API_KEY=your_key
OPENROUTER_API_KEY=your_key
```

कम से कम एक cloud key उपयोग करें, या शून्य API cost के लिए Ollama locally चलाएँ।

### 2. Backup keys से quotas बढ़ाएँ

```env theme={null}
GEMINI_API_KEYS=key2,key3
GROQ_API_KEY_2=backup_key
API_KEY_ROTATION=1
```

429 rate limits पर, Arka providers switch करने से पहले keys rotate करता है।

### 3. Routing tokens बचाएँ

```env theme={null}
ROUTE_MODE=symbolic
LLM_AUTO_FALLBACK=1
```

`symbolic` अधिकांश skills locally चलाता है; LLM केवल skill names classify करता है — पूरे skill manuals नहीं।

### 4. अपने hardware के लिए models चुनें

```bash theme={null}
arka select best model for my pc
arka select_model --apply
```

या एक पसंदीदा तेज़ model सेट करें:

```env theme={null}
AI_PREFERRED_PROVIDER=gemini
AI_PREFERRED_MODEL=gemini-2.0-flash
```

### 5. Verify

```bash theme={null}
arka setup
arka doctor
arka ai-models
```

## Context7 और MCP

**Context7** (`CONTEXT7_API_KEY`) वैकल्पिक है — यह library-docs MCP lookup को शक्ति देता है, chat LLM calls को नहीं। इसे तब तक छोड़ दें जब तक आपको live documentation search न चाहिए।

## संबंधित

* [LLM concepts](/concepts/llm) — providers और failover
* [Select model](/guides/select-model) — hardware-aware recommendations
* [Operation modes](/hi/guides/operation-modes) — `ROUTE_MODE` reference


## Related topics

- [AI agent guide — MCP पर Arka उपयोग करें](/hi/guides/ai-agents.md)
- [Quickstart: Arka इंस्टॉल करें और अपना पहला कमांड चलाएँ](/hi/quickstart.md)
- [3D बनाएं](/hi/guides/compose-3d.md)
- [X (Twitter) पर पोस्ट करना](/hi/guides/post-x.md)
- [Slides बनाएं](/hi/guides/compose-slides.md)