ElevenLabs CLI

अपनी कमांड लाइन से अपने वॉइस एजेंट्स को कोड की तरह मैनेज करें।

परिचय

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

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

GitHub पर पूरा सोर्स कोड देखें और योगदान दें।

इंस्टॉल करने की ज़रूरत नहीं

अगर आप Claude या किसी अन्य MCP क्लाइंट से काम करते हैं, तो होस्टेड MCP सर्वर बिना किसी लोकल इंस्टॉलेशन के एजेंट मैनेजमेंट टूल्स देता है। जब एजेंट्स को वर्शन कंट्रोल में रखना हो, तो CLI इस्तेमाल करें; बातचीत के ज़रिए मैनेजमेंट के लिए होस्टेड MCP सर्वर इस्तेमाल करें।

इंस्टॉलेशन

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

brew install elevenlabs/tap/elevenlabs

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

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

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

1

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

elevenlabs agents init

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

2

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

elevenlabs auth login

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

3

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

elevenlabs agents add "My Assistant" --template assistant

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

4

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

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 सेट करें।

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

elevenlabs auth login

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

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

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

elevenlabs agents add "Agent Name" [options]

विकल्प:

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

उदाहरण:

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

टेम्पलेट्स

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

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

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

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

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

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

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

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

elevenlabs agents templates list

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

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

elevenlabs agents push

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

एजेंट स्टेटस देखें
elevenlabs agents status

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

elevenlabs agents pull

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

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

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

वेबहुक टूल्स

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

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

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

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

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

विजेट जनरेशन

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

elevenlabs agents widget embed <agent_id>

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

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

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

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

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

{
"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 पाइपलाइन इंटीग्रेशन

# 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