widdx 1.31.1

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 + Cerebras + Groq + Mistral + 6 Free Models

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 / Fedora / Arch)

pip install widdx
# or isolated:
pipx 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    # Web UI works best on mobile

Web UI (Browser-based IDE)

pip install "widdx[web]"   # installs fastapi + uvicorn
widdx web                  # opens http://localhost:8520
# or inside TUI:
/web

Optional: Add API keys for premium models

# Inside TUI:
/key deepseek sk-...        # DeepSeek V4 Pro
/key google   AIza...       # Google Gemini
/key groq     gsk_...       # Groq (fastest, free tier)
/key cerebras csk-...       # Cerebras (~3000 tok/s)
/key mistral  your-key...   # Mistral / Devstral (free)

---

🖥️ Usage

widdx                  # Launch interactive TUI
widdx "build API"      # Run a task directly
widdx web              # Open browser-based Web UI
widdx web --port 9000  # Custom port

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 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 execution
/plan <desc>	Phased project planning
/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

---

🌐 Web UI — Browser-Based AI IDE

WIDDX v1.31.0 ships a full AI-powered IDE in your browser:

┌──────────────────────────────────────────────────────────────────┐
│  WIDDX  │  opencode ▾  │────── Ready · opencode ──────│  ⚙ ⊞ ⎇  │
├─────────┬──────────────┬──────────────────────┬─────────────────┤
│ ⊟ Files │  Explorer    │   Monaco Editor      │  🗲 Artifacts   │
│ 🔍 Search│  ├─ src/     │   (syntax highlight) │  ├─ index.html  │
│ 🤖 Agents│  │  └─ main  │   ─────────────────  │  └─ styles.css  │
│ ⎇ Git   │  └─ tests/   │   xterm.js Terminal  ├─────────────────┤
│         │              │   $ npm run dev...   │  ✓ Steps (12)   │
├─────────┴──────────────┴──────────────────────┤  ├─ ✓ Read      │
│  Chat with AI                                 │  ├─ ✓ Write     │
│  ┌─────────────────────────────────────┐      │  └─ ⏳ Bash     │
│  │ Ask WIDDX to build, fix, analyze...│ ↑    │                 │
│  └─────────────────────────────────────┘      │                 │
└──────────────────────────────────────────────────────────────────┘

Features:

• 🗂️ File Explorer — browse, create, rename, delete with right-click menu
• ✏️ Monaco Editor — VS Code's editor with syntax highlighting for 15+ languages
• 💻 xterm.js Terminal — real terminal showing live tool output
• 💬 AI Chat — WebSocket streaming with SSE fallback
• 🗲 Artifacts — HTML previews, code files, reports with fullscreen viewer
• 📋 Steps Timeline — real-time tool execution tracking
• 🌙 Dark / Light theme toggle
• 📱 Fully responsive — works on mobile, tablet, desktop
• 🔒 Bearer token auth via WIDDX_WEB_KEY env var

# Start with auth:
WIDDX_WEB_KEY=mypassword widdx web

# Custom port, no browser:
widdx web --port 9000 --no-open

---

🛠️ Universal Tool System — AI Installs What It Needs

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

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

Supports: 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
├── tool_loop/             # Agent execution loop
├── tools/                 # Tool implementations + auto-install
├── pipeline/              # Adaptive execution pipeline
├── memory/                # SQLite memory + learning
├── agent_factory/         # Dynamic agent team generation
├── agents/                # 12 specialized agents
├── skills/                # 17 built-in skills
├── hooks/                 # Lifecycle event system
├── verifier/              # Verification + auto-fix loop
├── mcp/                   # MCP protocol support
├── scaffolder/            # Project scaffolding
├── project_planner/       # Phased project planning
├── repl/                  # TUI command handlers
├── ui/textual_app/        # Textual TUI (primary interface)
├── web/                   # FastAPI Web UI (new in v1.31.0)
│   ├── __init__.py        # Server + all API routes
│   ├── templates/index.html
│   └── static/
│       ├── script.js      # Full SPA logic (~1600 lines)
│       └── style.css      # Responsive dark/light theme
├── 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

• No shell=True — all commands use parsed argument lists
• Config files restricted to owner read/write (chmod 600)
• Web UI: path traversal prevention, rate limiting, Bearer token auth
• Hooks security checker blocks dangerous commands
• Audit logging for traceability

---

📄 License

Proprietary. © 2026 Muhammad Muslih — Widdx.

Commercial licensing: [e-mail]

---

🛠️ Built by Muhammad Muslih

---

🇸🇦 عربي

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

Windows

pip install widdx
widdx

macOS / Linux

pip3 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

واجهة الويب

pip install "widdx[web]"
widdx web

🖥️ الاستخدام

widdx                    # تشغيل TUI التفاعلي
widdx "ابنِ API"         # مهمة مباشرة
widdx web                # فتح واجهة الويب

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

الأمر	الوصف
/help	كل الأوامر
/config	الإعدادات والمفاتيح
/check	فحص النظام (14 نقطة)
/key deepseek sk-...	إضافة مفتاح DeepSeek
/key groq gsk_...	إضافة مفتاح Groq
/web	تشغيل واجهة المتصفح
/schedule	جدولة المهام (cron)
/upgrade	تحديث widdx
/tools	الأدوات القابلة للتثبيت التلقائي
/git	حالة Git

🌐 واجهة الويب (v1.31.0)

واجهة IDE كاملة في المتصفح تشمل:

• مستكشف الملفات مع قائمة السياق
• محرر Monaco (VS Code) مع تلوين الأكواد
• طرفية xterm.js تعرض مخرجات الأدوات مباشرة
• دردشة AI مع بث WebSocket
• عارض الـ Artifacts (HTML، كود، تقارير)
• دعم كامل للشاشات الصغيرة (موبايل)

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

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

📄 الترخيص

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

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