Metadata-Version: 2.4
Name: widdx
Version: 1.29.4
Summary: Build anything from your terminal — autonomous AI, zero API costs.
Author-email: Muhammad Muslih <mem3071990@gmail.com>
Project-URL: Homepage, https://github.com/widdx1990/widdx-cli
Project-URL: Repository, https://github.com/widdx1990/widdx-cli
Project-URL: Issues, https://github.com/widdx1990/widdx-cli/issues
Project-URL: Changelog, https://github.com/widdx1990/widdx-cli/blob/main/CHANGELOG.md
Keywords: ai,deepseek,cli,orchestration,agent,autonomous,coding-agent,terminal,arabic
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: openai<3.0,>=1.68.0
Requires-Dist: click<9.0,>=8.1.0
Requires-Dist: rich<16.0,>=13.9.0
Requires-Dist: pyyaml<7.0,>=6.0.2
Requires-Dist: arabic-reshaper<4.0,>=3.0.0
Requires-Dist: python-bidi<0.7,>=0.6.7
Requires-Dist: prompt-toolkit<4.0,>=3.0.0
Requires-Dist: croniter<3.0,>=2.0.0
Requires-Dist: tomli<3.0,>=2.0.0; python_version < "3.11"
Requires-Dist: sentence-transformers<4.0,>=3.0.0
Requires-Dist: textual<9.0,>=2.0.0
Provides-Extra: dev
Requires-Dist: pytest<10.0,>=9.0.3; extra == "dev"
Requires-Dist: pytest-cov<7.0,>=5.0.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Provides-Extra: telegram
Requires-Dist: python-telegram-bot<22.0,>=20.0; extra == "telegram"
Provides-Extra: web
Requires-Dist: fastapi<1.0,>=0.104.0; extra == "web"
Requires-Dist: uvicorn<1.0,>=0.24.0; extra == "web"
Dynamic: license-file

<div align="center">

# ⚡ WIDDX CLI

### Build anything from your terminal — autonomous AI, zero API costs.

**DeepSeek V4 + Google Gemini + 5 Free Models — No API Key Required**

[![PyPI](https://img.shields.io/pypi/v/widdx?style=flat-square&color=00e5a0)](https://pypi.org/project/widdx/)
[![Python](https://img.shields.io/badge/Python-3.10+-blue?style=flat-square)](https://www.python.org/)
[![Version](https://img.shields.io/badge/Version-1.29.4-brightgreen?style=flat-square)](CHANGELOG.md)
[![Platforms](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux%20%7C%20Raspberry%20Pi-orange?style=flat-square)]()
[![Downloads](https://img.shields.io/pypi/dm/widdx?style=flat-square&color=blue)](https://pypi.org/project/widdx/)

```bash
pip install widdx && widdx
```

*One command. No config. No API key needed.*

</div>

---

## 📦 Installation — All Operating Systems

### Windows
```powershell
pip install widdx
widdx
```

### macOS
```bash
pip3 install widdx
widdx
```

### Linux (Ubuntu/Debian)
```bash
pip install widdx
# or with pipx for isolation:
pipx install widdx
widdx
```

### Linux (Fedora/RHEL)
```bash
pip install widdx
widdx
```

### Linux (Arch)
```bash
pip install widdx
widdx
```

### Raspberry Pi (piwheels)
```bash
pip install widdx
widdx
```

### Android (Termux)
```bash
pkg install python git rust binutils
pip install --no-deps widdx
pip install openai click rich pyyaml textual arabic-reshaper python-bidi prompt-toolkit croniter
widdx web    # Web UI works best on mobile
```

### Optional: Add API keys for higher quality
```bash
# Inside TUI, type:
/key deepseek sk-...      # DeepSeek V4
/key google AIza...        # Google Gemini
```

---

## 🖥️ Usage

```bash
widdx                  # Launch interactive TUI
widdx "build API"      # Run a task directly
widdx --fast           # Skip prompts, depth 1
```

### All management inside TUI via `/commands`:

| Command | Description |
|---------|-------------|
| `/help` | Show all commands |
| `/config` | Full configuration and API keys |
| `/check` | 14-point system diagnostics |
| `/key <provider> <key>` | Set API key |
| `/providers` | Manage AI providers |
| `/model` | Model info and session cost |
| `/schedule list\|add\|remove\|run` | Cron-based task scheduling |
| `/web` | Start browser Web UI on localhost:8520 |
| `/upgrade` | Upgrade to latest version |
| `/tools` | Show auto-detectable system tools |
| `/spec [name]` | Spec-driven development workflow |
| `/agents <task>` | Multi-agent team |
| `/plan <desc>` | Phased project plan |
| `/bootstrap <tech>` | Generate skills for a technology |
| `/git` | Git status |
| `/search <query>` | Search codebase |
| `/undo` | Undo last file change |
| `/save <name>` | Save session |
| `/clear` | Clear conversation |
| `/compact` | Summarize history |
| `/memory` | Show project context |
| `/learn` | Self-learning ledger |

---

## 🛠️ Universal Tool System — AI Installs What It Needs

WIDDX can detect and install ANY tool needed for ANY task — automatically:

```
You: "scan this network for open ports"
AI:   "I need nmap. Installing..." → winget install nmap → scans ports

You: "convert all MP4 files to GIF"  
AI:   "I need ffmpeg. Installing..." → winget install ffmpeg → converts

You: "crack this password hash"
AI:   "I need hashcat. Installing..." → choco install hashcat → cracks
```

The AI knows: winget, choco, apt, brew, dnf, pacman, snap, flatpak, pip, npm, cargo, go install.

---

## 🏗️ Architecture

```
widdx/
├── cli.py                 # Single entry point → TUI
├── config.py              # Configuration + provider management
├── router/                # Multi-provider AI routing + intent classification
├── tool_loop/             # Agent execution loop with tools
├── tools/                 # Tool implementations + auto-install system
├── pipeline/              # Adaptive execution pipeline + preflight checks
├── memory/                # SQLite memory store + learning
├── agent_factory/         # Dynamic agent team generation
├── agents/                # 12 specialized agent definitions
├── skills/                # 17 built-in skills
├── hooks/                 # Lifecycle event system
├── verifier/              # Verification + auto-fix loop
├── mcp/                   # MCP protocol (builtin + external servers)
├── scaffolder/            # Project scaffolding
├── project_planner/       # Phased project planning
├── repl/                  # Command handlers (used by TUI)
├── ui/textual_app/        # Textual TUI (primary interface)
├── web/                   # FastAPI Web UI
├── semantic_index.py      # Local RAG search
└── scheduler.py           # Cron-based task scheduling
```

---

## ⚙️ Configuration

`~/.widdx/config.yaml`:

```yaml
models:
  architect:
    model: deepseek-v4-pro
  executor:
    model: deepseek-v4-flash
    max_tokens: 32768

pipeline:
  complex_threshold: 3

memory:
  db_path: ~/.widdx/memory.db
```

---

## 🔒 Security

- Commands use parsed argument lists (no `shell=True`)
- Config files restricted to owner read/write (600)
- Hooks security checker blocks dangerous commands
- Audit logging for traceability

---

## 📄 License

**Proprietary.** &copy; 2026 Muhammad Muslih — Widdx.

Commercial licensing: mem3071990@gmail.com

---

<div align="center">
🛠️ Built by [Muhammad Muslih](https://github.com/widdx1990)
</div>

---

<div dir="rtl" align="right">

## 🇸🇦 عربي

### 📦 التثبيت على جميع الأنظمة

**Windows**
```powershell
pip install widdx
widdx
```

**macOS**
```bash
pip3 install widdx
widdx
```

**Linux (Ubuntu/Debian)**
```bash
pip install widdx
widdx
```

**Raspberry Pi**
```bash
pip install widdx
widdx
```

**Android (Termux)**
```bash
pkg install python git rust binutils
pip install --no-deps widdx
pip install openai click rich pyyaml textual arabic-reshaper python-bidi prompt-toolkit croniter
widdx web
```

### 🖥️ الاستخدام

```bash
widdx                    # تشغيل TUI
widdx "ابنِ API"         # مهمة مباشرة
```

كل الإدارة بداخل TUI عبر `/commands`:

| الأمر | الوصف |
|---|---|
| `/help` | كل الأوامر |
| `/config` | الإعدادات والمفاتيح |
| `/check` | فحص النظام |
| `/key deepseek sk-...` | إضافة مفتاح |
| `/web` | تشغيل واجهة المتصفح |
| `/schedule` | جدولة المهام |
| `/upgrade` | تحديث widdx |
| `/tools` | الأدوات القابلة للتثبيت التلقائي |
| `/git` | حالة Git |

### 🛠️ التثبيت التلقائي للأدوات

widdx يثبت أي أداة يحتاجها تلقائيًا. مثلاً تطلب "امسح الشبكة" — يثبت nmap ويستخدمه.

### 🏗️ الهيكل

```
widdx/
├── cli.py               # نقطة دخول وحيدة → TUI
├── router/              # توجيه متعدد + تصنيف النية
├── tool_loop/           # حلقة الأدوات
├── tools/               # الأدوات + التثبيت التلقائي
├── pipeline/            # خط أنابيب تنفيذ متكيف
├── memory/              # ذاكرة SQLite
├── agent_factory/       # توليد فرق الوكلاء
├── agents/              # 12 وكيل متخصص
├── skills/              # 17 مهارة
├── hooks/               # نظام الأحداث
├── verifier/            # تحقق + تصحيح تلقائي
├── web/                 # واجهة ويب FastAPI
├── ui/textual_app/      # واجهة TUI
└── semantic_index.py    # بحث دلالي محلي
```

### 📄 الترخيص

**احتكاري.** &copy; 2026 محمد مصلح — Widdx.

للاستخدام التجاري: mem3071990@gmail.com

</div>
