---

🎯 यह क्या है?

Claw Codex Claude Code का एक पूर्ण Python पुनर्लेखन है, वास्तविक TypeScript स्रोत कोड पर आधारित।

⚠️ महत्वपूर्ण: यह केवल स्रोत कोड नहीं है

लीक हुए TypeScript स्रोत के विपरीत, Claw Codex एक पूर्ण रूप से कार्यात्मक, चलने योग्य CLI उपकरण है:

• ✅ कार्यशील CLI — केवल कोड नहीं, बल्कि एक पूर्ण रूप से कार्यात्मक कमांड-लाइन उपकरण जिसे आप आज उपयोग कर सकते हैं
• ✅ वास्तविक स्रोत पर आधारित — वास्तविक Claude Code TypeScript कार्यान्वयन से पोर्ट किया गया
• ✅ अधिकतम निष्ठा — अनुकूलन करते समय मूल आर्किटेक्चर संरक्षित रखता है
• ✅ Python नेटिव — स्वच्छ, अभिव्यंजक Python पूर्ण प्रकार संकेतों के साथ
• ✅ उपयोगकर्ता अनुकूल — आसान सेटअप, इंटरैक्टिव REPL, व्यापक दस्तावेज़
• ✅ निरंतर सुधार — उन्नत त्रुटि हैंडलिंग, परीक्षण, दस्तावेज़ीकरण

🚀 अभी आज़माएं! इसे फोर्क करें, संशोधित करें, अपना बनाएं! Pull requests का स्वागत है!

---

🌿 /eco टोकन संपीड़न — Bash आउटपुट पर मापा गया -80%

/eco चालू करें और ClawCodex हर Bash परिणाम की मॉडल-बाउंड रेंडरिंग को RTK से पोर्ट किए गए नियतात्मक फ़िल्टरों से संपीड़ित करता है: विफलता-केंद्रित टेस्ट सारांश, औपचारिक शोर हटाना (git/pip/npm), लॉग डीडुप्लीकेशन और पुनर्प्राप्ति-योग्य ट्रंकेशन — पूरा कच्चा आउटपुट एक चलाने-योग्य संकेत के पीछे डिस्क पर सुरक्षित रहता है। कभी बदतर नहीं की गारंटी: जो संपीड़न कच्ची रेंडरिंग से बेहतर नहीं, वह छोड़ दिया जाता है, और त्रुटि पंक्तियाँ हमेशा बची रहती हैं।

उत्पादन पाइपलाइन से दोहराए गए 27 वास्तविक ऑपरेशनों पर मापा गया (tiktoken cl100k_base टोकन):

ऑपरेशन	कच्चा	/eco	बचत
pytest (विफलताओं सहित)	1,347	390	-71%
git clone --progress	6,868	18	-99%
ls -R src	9,088	225	-97%
log show --last 90s (34k पंक्तियाँ)	10,512	1,977	-81%
पूरा कॉर्पस (27 ऑपरेशन)	92,989	17,767	-80%

पूर्ण तालिकाएँ और कार्यप्रणाली: eval/eco/।

⭐ Star History

✨ विशेषताएँ

बहु-प्रदाता समर्थन

providers = [
    # नेटिव / विशिष्ट प्रोटोकॉल
    "anthropic", "minimax", "deepseek", "zai", "openrouter", "openai", "gemini",
    # OpenAI-संगत प्रदाता
    "nvidia-nim", "atlascloud", "wanjie-ark", "volcengine", "xiaomi-mimo",
    "novita", "fireworks", "siliconflow", "siliconflow-cn", "arcee", "moonshot",
    "huggingface", "together", "stepfun", "deepinfra",
    # लोकल सर्वर (कोई API key आवश्यक नहीं)
    "ollama", "vllm", "sglang",
]  # 25 प्रदाता; nim, kimi, hf जैसे उपनाम स्वतः हल हो जाते हैं

इंटरैक्टिव REPL

>>> नमस्ते!
Assistant: नमस्ते! मैं Claw Codex हूं, एक Python पुनर्कार्यान्वयन...

>>> /help         # कमांड दिखाएं
>>> /             # कमांड और skills दिखाएं
>>> /save         # सत्र सहेजें
>>> /multiline    # बहु-पंक्ति मोड
>>> Tab           # स्वत:-पूर्णता
>>> /explain-code qsort.py   # skill चलाएं

Skills (Slash Commands)

See README.md for a quick tutorial on creating skills under .clawcodex/skills/<skill-name>/SKILL.md.

पूर्ण CLI

clawcodex --dangerously-skip-permissions              # REPL प्रारंभ करें
clawcodex login        # API कॉन्फ़िगर करें
clawcodex --version    # संस्करण जांचें
clawcodex config       # सेटिंग्स देखें

---

📊 स्थिति

घटक	स्थिति	संख्या
कमांड	✅ पूर्ण	150+
उपकरण	✅ पूर्ण	100+
परीक्षण कवरेज	✅ 90%+	75+ परीक्षण
दस्तावेज़ीकरण	✅ पूर्ण	10+ दस्तावेज़

---

🚀 त्वरित आरंभ

इंस्टॉल करें

# PyPI से इंस्टॉल करें (अनुशंसित)। पैकेज का नाम clawcodex-cli है,
# लेकिन इंस्टॉल होने वाला कमांड `clawcodex` ही रहता है।
pipx install clawcodex-cli
# या: uv tool install clawcodex-cli
# या सक्रिय वर्चुअल एनवायरनमेंट में: pip install clawcodex-cli

clawcodex --help

सोर्स से विकास करने के लिए:

git clone https://github.com/agentforce314/clawcodex.git
cd clawcodex

# venv बनाएं (uv अनुशंसित)
uv venv --python 3.11
source .venv/bin/activate

# पैकेज और डेवलपमेंट टूल इंस्टॉल करें
uv pip install -e ".[dev]"

कॉन्फ़िगरेशन फ़ाइल ~/.clawcodex/config.json में सहेजी जाती है। न्यूनतम उदाहरण:

{
  "default_provider": "deepseek",
  "providers": {
    "deepseek": {
      "api_key": "xxx-xxx",
      "base_url": "https://api.deepseek.com",
      "default_model": "deepseek-v4-pro"
    }
  },
  "env": {
    "TAVILY_API_KEY": "tvly-YOUR-TAVILY-API-KEY"
  }
}

नोट: WebSearch टूल के लिए TAVILY_API_KEY आवश्यक है — tavily.com पर कुंजी प्राप्त करें।

session, settings और env ब्लॉक वैकल्पिक हैं — इन्हें छोड़ने पर उचित डिफ़ॉल्ट मान लागू होते हैं (पूरी संरचना नीचे)।

कॉन्फ़िगर करें

विकल्प 1: इंटरैक्टिव (अनुशंसित)

python -m src.cli login

यह प्रक्रिया:

1. आपको एक प्रदाता चुनने के लिए कहेगी: anthropic / openai / gemini / zai / minimax / openrouter / deepseek, या कोई भी OpenAI-संगत वेंडर (together, novita, fireworks, moonshot, nvidia-nim, siliconflow, deepinfra, huggingface, …) और स्थानीय सर्वर (ollama / vllm / sglang)
2. उस प्रदाता की API कुंजी मांगेगी
3. वैकल्पिक रूप से एक कस्टम base URL सहेजेगी
4. वैकल्पिक रूप से एक डिफ़ॉल्ट मॉडल सहेजेगी
5. चयनित प्रदाता को डिफ़ॉल्ट के रूप में सेट करेगी

कॉन्फ़िगरेशन फ़ाइल ~/.clawcodex/config.json में सहेजी जाती है। उदाहरण संरचना:

{
  "default_provider": "deepseek",
  "providers": {
    "anthropic": {
      "api_key": "your-api-key",
      "base_url": "https://api.anthropic.com",
      "default_model": "claude-sonnet-4-6"
    },
    "openai": {
      "api_key": "your-api-key",
      "base_url": "https://api.openai.com/v1",
      "default_model": "gpt-5.4"
    },
    "zai": {
      "api_key": "your-api-key",
      "base_url": "https://api.z.ai/api/coding/paas/v4",
      "default_model": "glm-5.2"
    },
    "minimax": {
      "api_key": "your-api-key",
      "base_url": "https://api.minimaxi.com/anthropic",
      "default_model": "MiniMax-M2.7"
    },
    "openrouter": {
      "api_key": "your-api-key",
      "base_url": "https://openrouter.ai/api/v1",
      "default_model": "deepseek/deepseek-v4-pro"
    },
    "deepseek": {
      "api_key": "your-api-key",
      "base_url": "https://api.deepseek.com",
      "default_model": "deepseek-v4-pro"
    }
  },
  "session": {
    "auto_save": true,
    "max_history": 100
  },
  "settings": {
    "advisor_enabled": false,
    "advisor_model": "claude-sonnet-4-6",
    "advisor_client_mode": false,
    "advisor_provider": "openai"
  },
  "env": {
    "TAVILY_API_KEY": "tvly-YOUR-TAVILY-API-KEY"
  }
}

चलाएं

python -m src.cli          # REPL प्रारंभ करें
python -m src.cli --help   # सहायता दिखाएं

बस इतना ही! 3 चरणों में AI के साथ चैट करना शुरू करें।

---

💡 उपयोग

REPL कमांड

कमांड	विवरण
/help	सभी कमांड दिखाएं
/save	सत्र सहेजें
/load <id>	सत्र लोड करें
/multiline	बहु-पंक्ति मोड टॉगल करें
/clear	इतिहास साफ़ करें
/exit	REPL से बाहर निकलें

उदाहरण सत्र

---

🎓 Claw Codex क्यों?

वास्तविक स्रोत कोड पर आधारित

• क्लोन नहीं — वास्तविक TypeScript कार्यान्वयन से पोर्ट किया गया
• आर्किटेक्चरल निष्ठा — सिद्ध डिज़ाइन पैटर्न बनाए रखता है
• सुधार — बेहतर त्रुटि हैंडलिंग, अधिक परीक्षण, क्लीनर कोड

Python नेटिव

• प्रकार संकेत — पूर्ण प्रकार एनोटेशन
• आधुनिक Python — 3.10+ सुविधाओं का उपयोग करता है
• अभिव्यंजक — स्वच्छ Python कोड

उपयोगकर्ता केंद्रित

• 3-चरण सेटअप — क्लोन, कॉन्फ़िगर, चलाएं
• इंटरैक्टिव कॉन्फ़िगरेशन — clawcodex login आपका मार्गदर्शन करता है
• समृद्ध REPL — टैब पूर्णता, सिंटैक्स हाइलाइटिंग
• सत्र दृढ़ता — अपना काम कभी न खोएं

---

📦 परियोजना संरचना

Claw-Codex/
├── src/
│   ├── cli.py           # CLI प्रविष्टि
│   ├── config.py        # कॉन्फ़िगरेशन
│   ├── repl/            # इंटरैक्टिव REPL
│   ├── providers/       # LLM प्रदाता
│   └── agent/           # सत्र प्रबंधन
├── tests/               # 75+ परीक्षण
└── docs/                # पूर्ण दस्तावेज़

---

🗺️ रोडमैप

• Python MVP
• बहु-प्रदाता समर्थन
• सत्र दृढ़ता
• सुरक्षा ऑडिट
• टूल कॉलिंग सिस्टम
• PyPI पैकेज
• Go संस्करण

---

🤝 योगदान

हम योगदान का स्वागत करते हैं!

# त्वरित देव सेटअप
pip install -e .[dev]
python -m pytest tests/ -v

दिशानिर्देशों के लिए CONTRIBUTING.md देखें।

---

📖 दस्तावेज़ीकरण

• SETUP_GUIDE.md — विस्तृत स्थापना
• CONTRIBUTING.md — विकास मार्गदर्शिका
• TESTING.md — परीक्षण मार्गदर्शिका
• CHANGELOG.md — संस्करण इतिहास

---

⚡ प्रदर्शन

• स्टार्टअप: < 1 सेकंड
• मेमोरी: < 50MB
• प्रतिक्रिया: स्ट्रीमिंग (वास्तविक समय)

---

🔒 सुरक्षा

✅ सुरक्षा ऑडिट पूर्ण

• Git में कोई संवेदनशील डेटा नहीं
• API कुंजी कॉन्फ़िगरेशन में एन्क्रिप्टेड
• .env फ़ाइलें अनदेखी की गईं
• उत्पादन के लिए सुरक्षित

---

📄 लाइसेंस

MIT लाइसेंस — LICENSE देखें

---

🙏 स्वीकृतियाँ

• Claude Code TypeScript स्रोत पर आधारित
• स्वतंत्र शैक्षिक परियोजना
• Anthropic से संबद्ध नहीं

---