⚡ WIDDX CLI

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

DeepSeek V4 + Google Gemini + Cerebras + Groq + Mistral + Ollama + 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
widdx bot                  # Start Telegram bot
widdx bot -d ~/my-project  # Telegram bot for specific project

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
`/index`	Build semantic index for codebase
`/web`	Start Web UI on localhost:8520
`/upgrade`	Upgrade to latest version
`/spec [name]`	Spec-driven development workflow
`/agents <task>`	Multi-agent team (up to 8 agents)
`/plan <desc>`	Phased project planning
`/bootstrap <tech>`	Generate skills for a technology
`/git`	Git status
`/search <query>`	Search codebase
`/undo`	Undo last file change or chat clear
`/clear`	Clear conversation (Ctrl+Z to undo)
`/compact`	Summarize history to save context
`/memory`	Show project context
`/learn`	Self-learning ledger

🤖 Telegram Bot — Control WIDDX from Anywhere

widdx bot                              # Start with TELEGRAM_BOT_TOKEN env var
widdx bot --token "123:abc"            # Pass token directly
widdx bot -d ~/my-project              # Work in specific project

Setup: Create a bot via @BotFather, set TELEGRAM_BOT_TOKEN.

🌐 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 + diff viewer
💻 xterm.js Terminal — real terminal showing live tool output
💬 AI Chat — WebSocket streaming with SSE fallback
⚡ Multi-Agent Pipeline — up to 8 parallel agents for complex tasks
🧠 Semantic Index — local code understanding (80MB model, zero API cost)
🗲 Artifacts — HTML previews, code files, reports with fullscreen viewer
📋 Steps Timeline — real-time tool execution tracking
🔄 Compact/Undo — compact history (Ctrl+Shift+C), undo clear (Ctrl+Z)
🏥 Provider Health — real-time provider status in status bar
🌙 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                 # Entry point (TUI + web + bot + task)
├── config.py              # Configuration + provider management
├── key_manager.py         # Centralized API key management (10+ providers)
├── router/                # Multi-provider AI routing + streaming
├── tool_loop/             # Agent execution loop (Claude Code pattern)
├── tools/                 # File ops, shell, search, web, auto-install
├── pipeline/              # Adaptive depth-gated execution pipeline
├── memory/                # SQLite memory + repair patterns + learning
├── agent_factory/         # Dynamic multi-agent team design & execution
├── agents/                # 12 specialized domain agents
├── skills/                # 17 built-in skill files (.md)
├── hooks/                 # Lifecycle event hooks (Pre/PostToolUse)
├── verifier/              # Auto-fix verification loop (syntax → test → fix)
├── mcp/                   # MCP protocol (stdio + HTTP servers)
├── scaffolder/            # Project scaffolding
├── project_planner/       # Phased project planning + execution
├── repl/                  # TUI command handlers
├── ui/textual_app/        # Textual TUI (primary interface)
├── web/                   # FastAPI Web IDE
│   ├── routes.py          # API endpoints (50+ routes)
│   ├── auth.py            # Bearer token + rate limiting
│   ├── terminal.py        # PTY WebSocket terminal
│   └── static/
│       ├── script.js      # Full SPA (~4200 lines)
│       └── style.css      # Responsive dark/light theme (~3400 lines)
├── telegram_bot.py        # Telegram bot integration
├── semantic_index.py      # Local RAG (sentence-transformers)
├── evolution.py           # Decision evaluation + weight tracking
├── self_learning.py       # Pattern discovery from task history
└── repair_memory.py       # Known fix pattern storage

⚙️ 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

Commercial licensing: mem3071990@gmail.com

🛠️ 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                  # فتح واجهة الويب
widdx bot                  # تشغيل بوت تلغرام

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

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

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

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

مستكشف الملفات مع قائمة السياق
محرر Monaco (VS Code) مع Diff Viewer
طرفية xterm.js تعرض مخرجات الأدوات مباشرة
نظام Multi-Agent حتى 8 وكلاء للمهام المعقدة
فهرس دلالي محلي (80MB نموذج)
ضغط المحادثة (Compact) واسترجاع الحذف (Undo)
حالة المزوّدين مباشرة في شريط الحالة
دعم كامل للشاشات الصغيرة (موبايل)

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

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

📄 الترخيص

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

Metadata

Release files for widdx 1.42.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for widdx 1.42.4
File	Size	Uploaded
widdx-1.42.4.tar.gz	885.0 kB	Jul 23, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for widdx 1.42.4
File	Interpreter	ABI	Platform	Reset
widdx-1.42.4-py3-none-any.whl 912.8 kB Jul 23, 2026	Python 3	none	any	Details

Total release size: 1.8 MB

Release files / widdx-1.42.4.tar.gz

Download URL	widdx-1.42.4.tar.gz
Size	885.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`8b26c6514145be463c7c7afaa1256fd7d81ade6c0bf9b32323b70dfa8e5b5c22`
BLAKE2b-256 checksum How to use checksums	`ca5468f05126b786faef821b0c065f24532c05e593116778b8df8e45e70ba212`
Upload date	Jul 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.13.14`

Release files / widdx-1.42.4-py3-none-any.whl

Download URL	widdx-1.42.4-py3-none-any.whl
Size	912.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`92dd9f4d8d34121546684b9a7f67150eafccb42a5e5d2df22ab998b91ec94060`
BLAKE2b-256 checksum How to use checksums	`434b7900ae04b6f237be03a090d19076be633a42cfc61cbd949af1848e88ae52`
Upload date	Jul 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.13.14`