> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# ElevenLabs CLI

## परिचय

ElevenLabs CLI आपको अपने टर्मिनल से ElevenLabs एजेंट्स एक्सेस करने देता है और उन्हें मैनेज करने के नए तरीके देता है:

* एजेंट्स को अपने वर्शन कंट्रोल सिस्टम में कोड के रूप में स्टोर करें
* अपने एजेंट्स को अपने-आप डिप्लॉय करने के लिए CI/CD इंटीग्रेशन सेट अप करें
* अपने कोडिंग एजेंट को अपने वॉइस एजेंट्स एक्सेस और मैनेज करने दें

> **सीधे कोड पर जाना पसंद करेंगे?**
>
> [GitHub पर पूरा सोर्स कोड देखें और योगदान दें](https://github.com/elevenlabs/cli)।

> **इंस्टॉल करने की ज़रूरत नहीं**
>
> अगर आप Claude या किसी अन्य MCP क्लाइंट से काम करते हैं, तो [होस्टेड MCP सर्वर](/docs/hi/eleven-agents/operate/hosted-mcp) बिना किसी लोकल इंस्टॉलेशन के एजेंट मैनेजमेंट टूल्स देता है। जब एजेंट्स को वर्शन कंट्रोल में रखना हो, तो CLI इस्तेमाल करें; बातचीत के ज़रिए मैनेजमेंट के लिए होस्टेड MCP सर्वर इस्तेमाल करें।

## इंस्टॉलेशन

Homebrew (macOS) और Scoop (Windows) सुझाए गए इंस्टॉल तरीके हैं और एक स्टैंडअलोन बाइनरी उपलब्ध कराते हैं।

**`Homebrew (macOS)`**

```bash title="Homebrew (macOS)"
brew install elevenlabs/tap/elevenlabs
```

**`Scoop (Windows)`**

```powershell title="Scoop (Windows)"
scoop bucket add elevenlabs https://github.com/elevenlabs/scoop-bucket
scoop install elevenlabs
```

**`npm`**

```bash title="npm"
npm install -g @elevenlabs/cli
```

**`curl`**

```bash title="curl"
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/elevenlabs/cli/releases/latest/download/elevenlabs-cli-installer.sh | sh
```

> **Tip**
>
> AI कोडिंग असिस्टेंट के साथ काम कर रहे हैं? अपने प्रोजेक्ट में `elevenlabs generate-skills` चलाएं। इससे हर कमांड ग्रुप के लिए `skills/` में एक
> `SKILL.md` लिखा जाएगा, ताकि आपके असिस्टेंट को डॉक्यूमेंटेशन पेस्ट किए बिना CLI की पूरी जानकारी मिल सके। उन्हें कहीं और रखने के लिए `--output-dir` इस्तेमाल करें। यह CLI की अपनी
> एम्बेडेड API डेफ़िनिशन पढ़ता है, इसलिए इसे API key की ज़रूरत नहीं होती और यह ऑफ़लाइन भी काम करता है — साथ ही आपके इंस्टॉल किए गए CLI वर्शन के अनुसार बना रहता है।

इंस्टॉलेशन के बाद, `elevenlabs` कमांड आपके टर्मिनल में ग्लोबली उपलब्ध होगी।

## क्विक स्टार्ट

### नया प्रोजेक्ट इनिशियलाइज़ करें

```bash
elevenlabs agents init
```

इससे कॉन्फ़िगरेशन डायरेक्टरी और रजिस्ट्री फ़ाइलों के साथ प्रोजेक्ट स्ट्रक्चर बनता है।

### ElevenLabs से ऑथेंटिकेट करें

```bash
elevenlabs auth login
```

OAuth के ज़रिए ऑथेंटिकेट करने के लिए इससे एक ब्राउज़र विंडो खुलेगी। CLI क्रेडेंशियल्स सत्यापित करेगा और उन्हें सुरक्षित रूप से स्टोर करेगा।

### अपना पहला एजेंट बनाएं

```bash
elevenlabs agents add "My Assistant" --template assistant
```

इससे असिस्टेंट टेम्पलेट का उपयोग करके नया एजेंट कॉन्फ़िगरेशन बनता है।

### ElevenLabs प्लेटफ़ॉर्म पर पुश करें

```bash
elevenlabs agents push
```

इससे आपका लोकल एजेंट कॉन्फ़िगरेशन ElevenLabs प्लेटफ़ॉर्म पर अपलोड होता है।

## प्रोजेक्ट स्ट्रक्चर

CLI एक संरचित प्रोजेक्ट डायरेक्टरी बनाता है:

```
your_project/
├── agents.json              # Central agent configuration registry
├── tools.json               # Tool definitions registry
├── tests.json               # Test definitions registry
├── agent_configs/           # Agent configuration files
├── tool_configs/            # Tool configuration files
└── test_configs/            # Test configuration files
```

## ऑथेंटिकेशन

`elevenlabs auth login` क्रेडेंशियल्स को आपके ऑपरेटिंग सिस्टम के कीरिंग में स्टोर करता है — macOS पर Keychain,
Windows पर Credential Manager और Linux पर Secret Service। जहाँ कोई कीरिंग उपलब्ध नहीं है, वहाँ CLI
`0600` परमिशन के साथ `~/.config/elevenlabs/auth-keyring.json` पर फ़ॉलबैक करता है। कौन सा स्रोत इस्तेमाल हो रहा है यह देखने के लिए
`elevenlabs auth status` चलाएँ और स्टोर की गई एंट्री हटाने के लिए `elevenlabs auth logout` चलाएँ।

CI के लिए, लॉग इन करने के बजाय एनवायरनमेंट या `.env` फ़ाइल में `ELEVENLABS_API_KEY` सेट करें।

### ऑथेंटिकेशन कमांड्स

**`लॉग इन`**

```bash title="लॉग इन"
elevenlabs auth login
```

**`लॉग आउट`**

```bash title="लॉग आउट"
elevenlabs auth logout
```

## एजेंट मैनेजमेंट

### एजेंट्स बनाना

पहले से बने टेम्पलेट्स का इस्तेमाल करके एजेंट्स बनाएं:

```bash
elevenlabs agents add "Agent Name" [options]
```

**विकल्प:**

* `--template <type>`: उपलब्ध टेम्पलेट्स में से चुनें (डिफ़ॉल्ट: default)
* `--skip-upload`: प्लेटफ़ॉर्म पर अपलोड किए बिना लोकली बनाएं

**उदाहरण:**

```bash
elevenlabs agents add "Customer Support Bot" --template customer-service
```

### टेम्पलेट्स

CLI सामान्य उपयोग के मामलों के लिए छह पहले से बने टेम्पलेट्स उपलब्ध कराता है:

#### default

सभी उपलब्ध फ़ील्ड्स, उपयुक्त डिफ़ॉल्ट्स, पूरा वॉइस/टेक्स्ट सपोर्ट, विजेट कस्टमाइज़ेशन और मूल्यांकन मानदंडों के साथ संपूर्ण कॉन्फ़िगरेशन।

#### minimal

बुनियादी प्रॉम्प्ट, भाषा, TTS और बातचीत सेटिंग्स समेत सिर्फ़ ज़रूरी फ़ील्ड्स।

#### voice-only

टेक्स्ट इनपुट बंद करके और उन्नत वॉइस सेटिंग्स के साथ वॉइस इंटरैक्शन के लिए ऑप्टिमाइज़ किया गया।

#### text-only

वॉइस फ़ीचर्स बंद करके टेक्स्ट-केंद्रित बातचीत।

#### customer-service

प्रोफ़ेशनल, सहानुभूतिपूर्ण प्रॉम्प्ट्स, कम तापमान (0.1), 30 मिनट की अवधि और मूल्यांकन मानदंड।

#### assistant

संतुलित रचनात्मकता (तापमान 0.3) और बहुमुखी वॉइस/टेक्स्ट सपोर्ट वाला सामान्य-उद्देश्य AI असिस्टेंट।

### टेम्पलेट कमांड्स

**`उपलब्ध टेम्पलेट्स की सूची`**

```bash title="उपलब्ध टेम्पलेट्स की सूची"
elevenlabs agents templates list
```

**`टेम्पलेट कॉन्फ़िगरेशन दिखाएं`**

```bash title="टेम्पलेट कॉन्फ़िगरेशन दिखाएं"
elevenlabs agents templates show <template>
```

### सिंक्रनाइज़ेशन

अपने लोकल कॉन्फ़िगरेशंस को ElevenLabs प्लेटफ़ॉर्म के साथ सिंक्रनाइज़ रखें:

**`सभी एजेंट्स पुश करें`**

```bash title="सभी एजेंट्स पुश करें"
elevenlabs agents push
```

**`बदलावों का प्रीव्यू (ड्राई रन)`**

```bash title="बदलावों का प्रीव्यू (ड्राई रन)"
elevenlabs agents push --dry-run
```

### स्टेटस और मॉनिटरिंग

**`एजेंट स्टेटस देखें`**

```bash title="एजेंट स्टेटस देखें"
elevenlabs agents status
```

### इंपोर्ट और एक्सपोर्ट

**`मौजूदा एजेंट्स इंपोर्ट करें`**

```bash title="मौजूदा एजेंट्स इंपोर्ट करें"
elevenlabs agents pull
```

**`खास एजेंट इंपोर्ट करें`**

```bash title="खास एजेंट इंपोर्ट करें"
elevenlabs agents pull --agent <agent_id>
```

**`एजेंट्स अपडेट करें`**

```bash title="एजेंट्स अपडेट करें"
elevenlabs agents pull --update
```

**`सभी एजेंट्स की सूची`**

```bash title="सभी एजेंट्स की सूची"
elevenlabs agents list
```

> **Note**
>
> डिफ़ॉल्ट रूप से, `elevenlabs agents pull` उन एजेंट्स को छोड़ देता है जो लोकली पहले से मौजूद हैं। ब्राउज़र या API से किए गए रिमोट बदलावों से लोकल कॉन्फ़िगरेशंस को ओवरराइड करने के लिए `--update`
> फ़्लैग इस्तेमाल करें।

## टूल मैनेजमेंट

एजेंट क्षमताएं बढ़ाने के लिए CLI दो प्रकार के टूल्स सपोर्ट करता है:

### वेबहुक टूल्स

ऑथेंटिकेशन और टाइमआउट कॉन्फ़िगरेशन के साथ HTTP API इंटीग्रेशन:

```bash
elevenlabs tools add "API Integration" --type "webhook" --config-path ./config.json
```

### क्लाइंट टूल्स

सीधे क्लाइंट-साइड इंटीग्रेशन:

```bash
elevenlabs tools add "Client Function" --type "client" --config-path ./config.json
```

## विजेट जनरेशन

वेब इंटीग्रेशन के लिए HTML एम्बेड कोड जनरेट करें:

```bash
elevenlabs agents widget embed <agent_id>
```

इससे ऐसा HTML कोड आउटपुट होता है:

```html
<elevenlabs-convai agent-id="agent_id_here"></elevenlabs-convai>
<script src="https://unpkg.com/@elevenlabs/convai-widget-embed" async></script>
```

## कॉन्फ़िगरेशन फ़ाइलें

### एजेंट कॉन्फ़िगरेशन स्ट्रक्चर

हर एजेंट कॉन्फ़िगरेशन में शामिल है:

```json
{
  "name": "Agent Name",
  "conversation_config": {
    "agent": {
      "language": "en",
      "prompt": {
        "prompt": "You are a helpful AI assistant.",
        "llm": "gemini-2.5-flash",
        "temperature": 0.0
      }
    },
    "tts": {
      "model_id": "eleven_turbo_v2",
      "voice_id": "cjVigY5qzO86Huf0OWal",
      "agent_output_audio_format": "pcm_16000"
    },
    "asr": {
      "provider": "scribe_realtime",
      "quality": "high",
      "user_input_audio_format": "pcm_16000"
    },
    "conversation": {
      "text_only": false,
      "max_duration_seconds": 600,
      "client_events": ["audio", "interruption"]
    }
  },
  "platform_settings": {
    "widget": {
      "variant": "full",
      "placement": "bottom-right"
    }
  },
  "tags": []
}
```

### CI/CD पाइपलाइन इंटीग्रेशन

```yml
# In your GitHub Actions workflow
- name: Deploy ElevenAgents agents
  run: |
    npm install -g @elevenlabs/cli
    export ELEVENLABS_API_KEY=${{ secrets.ELEVENLABS_API_KEY }}
    elevenlabs agents push --dry-run  # Preview changes
    elevenlabs agents push            # Deploy
    elevenlabs agents status          # Verify deployment
```