widdx 1.29.3

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

⚡ WIDDX CLI

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

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

pip install widdx && widdx

One command. No config. No API key needed.

---

📦 Installation — All Operating Systems

Windows

pip install widdx
widdx

macOS

pip3 install widdx
widdx

Linux (Ubuntu/Debian)

pip install widdx
# or with pipx for isolation:
pipx install widdx
widdx

Linux (Fedora/RHEL)

pip install widdx
widdx

Linux (Arch)

pip install widdx
widdx

Raspberry Pi (piwheels)

pip install widdx
widdx

Android (Termux)

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

# Inside TUI, type:
/key deepseek sk-...      # DeepSeek V4
/key google AIza...        # Google Gemini

---

🖥️ Usage

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:

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. © 2026 Muhammad Muslih — Widdx.

Commercial licensing: [e-mail]

---

🛠️ Built by [Muhammad Muslih](https://github.com/widdx1990)

---

🇸🇦 عربي

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

Windows

pip install widdx
widdx

macOS

pip3 install widdx
widdx

Linux (Ubuntu/Debian)

pip install widdx
widdx

Raspberry Pi

pip install widdx
widdx

Android (Termux)

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

🖥️ الاستخدام

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    # بحث دلالي محلي

📄 الترخيص

احتكاري. © 2026 محمد مصلح — Widdx.

للاستخدام التجاري: [e-mail]