Quickstart: Arka इंस्टॉल करें और अपना पहला कमांड चलाएँ

macOS, Linux, या Windows पर pipx से Arka इंस्टॉल करें — git clone नहीं — Gemini या Groq API keys सेट करें, arka doctor से जाँच करें, और पाँच मिनट से भी कम में अपना पहला प्राकृतिक-भाषा टर्मिनल कमांड चलाएँ।

Arka को macOS, Linux, या Windows पर चलाएँ — git clone या लोकल build की ज़रूरत नहीं। प्रकाशित Python पैकेज इंस्टॉल करें, arka setup चलाएँ, एक API key जोड़ें, और किसी भी टर्मिनल से arka का उपयोग करें।

एक नज़र में: Python 3.11+ चाहिए, एक LLM API key (Gemini या Groq की सिफ़ारिश), और वैकल्पिक रूप से पूरे skill router के लिए fish shell। अनुशंसित इंस्टॉल: pipx install "arka-agent[chat]" → arka setup → arka doctor → arka ask "what is Rust?". पूरे docs: Introduction।

Quickstart ट्यूटोरियल देखें:

Arka quickstart — install, configure, and run your first command

अनुशंसित रास्ता — pipx (या pip) से install, फिर verify और पूछें:

1. Install

pipx install "arka-agent[chat]"
arka setup

​

शुरू करने से पहले

Arka docs-as-code अपनाता है — यह साइट Mintlify पर बनी है और arka-agent.mintlify.site पर deploy होती है। खुद Arka उपयोग करने के लिए, आपको चाहिए:

• Python 3.11+
• कम से कम एक LLM API key (Gemini या Groq — free tier के लिए अनुशंसित)
• पूरे 70+ skill router के लिए fish shell (वैकल्पिक लेकिन अनुशंसित)

​

Install (source से build नहीं)

अधिकांश उपयोगकर्ताओं को सीधे arka-agent पैकेज install करना चाहिए। आपको repo clone करने, ./scripts/refetch.sh चलाने, या कुछ compile करने की ज़रूरत नहीं है — pip / pipx एक तैयार CLI download करता है।

pipx (अनुशंसित)

Isolated install — रोज़ के टर्मिनल उपयोग के लिए सर्वश्रेष्ठ। pipx चाहिए।

pipx install "arka-agent[chat]"
arka setup
arka doctor

अगर PyPI 404 लौटाता है (publish जारी है), तो नवीनतम release सीधे GitHub से install करें — फिर भी कोई लोकल build नहीं:

pipx install "arka-agent[chat] @ git+https://github.com/Sumit884-byte/arka.git"
arka setup
arka doctor

pip / venv

किसी मौजूदा virtual environment या user site-packages में install करें।

python3 -m pip install "arka-agent[chat]"
arka setup
arka doctor

GitHub fallback (clone नहीं):

python3 -m pip install "arka-agent[chat] @ git+https://github.com/Sumit884-byte/arka.git"
arka setup

Git clone (contributors)

केवल तभी ज़रूरत जब आप Arka खुद विकसित कर रहे हों या repo patch कर रहे हों।

git clone https://github.com/Sumit884-byte/arka.git
cd arka
./scripts/refetch.sh --install
arka setup

Editable dev

लाइव कोड बदलावों के साथ repo के अंदर काम करने वाले contributors के लिए।

git clone https://github.com/Sumit884-byte/arka.git && cd arka
python3 scripts/sync_bundled.py
pip install -e ".[chat]"
arka setup

Install के बाद, which arka को pipx के venv या आपके सक्रिय Python environment के अंतर्गत एक path प्रिंट करना चाहिए। arka doctor चलाएँ — fish install होने पर आपको Skills: full (70+) दिखना चाहिए, अन्यथा portable mode।

​

किसी भी टर्मिनल से Arka उपयोग करें

Install के बाद, एक नया टर्मिनल tab खोलें (ताकि PATH में pipx आ जाए) और चलाएँ:

arka ask "what is Rust?"
arka "convert 100 USD to INR"
arka route "summarize this repo"
arka help

वैकल्पिक — fish shell के साथ पूरे 70+ skill router को अनलॉक करें:

brew install fish          # macOS
arka reload                # loads bundled config.fish

fish के बिना भी, Arka portable mode में काम करता है: arka ask, calc, weather, plugins, और MCP।

​

शुरू करें

1. API keys कॉन्फ़िगर करें

   उदाहरण env फ़ाइल कॉपी करें और कम से कम एक provider key जोड़ें।

   cp .env.example ~/.config/arka/.env
   

   त्वरित शुरुआत के लिए न्यूनतम .env:

   GEMINI_API_KEY=your_key_here
   GROQ_API_KEY=your_key_here
   AI_PREFERRED_PROVIDER=gemini
   AI_PREFERRED_MODEL=gemini-2.0-flash
   AGENT_SPEAK=1
   

   Config paths OS के अनुसार अलग होते हैं। Linux में ~/.config/arka/, macOS में ~/Library/Application Support/arka/, और Windows में %APPDATA%\arka\।

2. Install जाँचें

   dependencies और API keys की पुष्टि के लिए diagnostics चलाएँ।

   arka doctor
   
3. अपना पहला कमांड चलाएँ

   एक सवाल पूछें और देखें कि Arka उसे web-answer skill पर route करता है।

   arka ask "what is Rust?"
   

   कुछ और आज़माएँ:

   arka "convert 100 USD to INR"
   arka council "should I learn Rust?"
   arka quiz python
   arka route "convert 100 USD to INR"
   arka help
   
4. Personalize करें (वैकल्पिक)

   interests चुनें और अपने अनुसार skill recommendations पाएँ।

   arka personalize wizard
   arka personalize recommend
   

   interest tags और non-interactive flags के लिए देखें Arka अनुभव को personalize करें।

5. fish shell install करें (वैकल्पिक)

   Fish पूरे 70+ skill router को खोलता है। pip package में config.fish शामिल है।

   # macOS
   brew install fish
   
   # Linux
   apt install fish
   
   # Windows
   arka "scoop install fish"
   

​

वैकल्पिक extras

Extra	जोड़ता है
[chat]	Agno, web search, trafilatura, sympy, geopy
[voice]	vosk, sounddevice
[pdf]	PrivateGPT client
[charts]	matplotlib
[all]	ऊपर सब कुछ

pip install "arka-agent[all]"

​

अगले कदम

sidebar को क्रम से देखें, या जो चाहिए वहाँ जाएँ:

Arka के साथ कोड कैसे लिखें

रोज़ का coding workflow — setup, edits, review, CI, और Cursor MCP।

CLI reference

सभी commands, aliases, और subcommands।

Skills catalog

आप Arka से क्या-क्या करवा सकते हैं।

Routing कैसे काम करता है

Offline rules, LLM fallback, और correction layer।

LLM configuration

Providers, failover, और per-skill models।

Configuration

Env vars, precedence, और built-in defaults।

Voice

Wake word, STT, और TTS setup।

Arka Council

Multi-persona deliberation।

Changelog

इस सप्ताह क्या नया है।