dulus 3.6.0__tar.gz → 3.7.0__tar.gz

{dulus-3.6.0/dulus.egg-info → dulus-3.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dulus
-Version: 3.6.0
+Version: 3.7.0
 Summary: Use IA as an agent without an API key. $0. Harvest your browser session for Gemini (guest, no login), Claude.ai, Claude Code, Kimi.com, Qwen, DeepSeek — drive them like an API, no per-token billing. Plus LiteLLM (100+ paid providers), local models via Ollama, /lang in 34 languages, Mesa Redonda, voice, OCR, MemPalace, embedded sandbox OS.
 Author: KevRojo
 License: GPL-3.0
@@ -37,6 +37,7 @@ Requires-Dist: typing-extensions>=4.10.0
 Requires-Dist: composio>=1.0.0rc2
 Requires-Dist: beautifulsoup4>=4.12.0
 Requires-Dist: sentry-sdk>=2.0.0
+Requires-Dist: truststore>=0.9
 Requires-Dist: pytesseract>=0.3.10
 Provides-Extra: memory
 Requires-Dist: mempalace>=3.3.4; extra == "memory"
@@ -65,7 +66,7 @@ Dynamic: license-file
 
 # ▲ DULUS
 >
-> `pip install dulus` → press Enter → working IA in 30 seconds. Try it.
+> `curl -fsSL …/install.sh | bash` → press Enter → working IA in 30 seconds. Try it.
 
 SET /sticky_input ON since the first run for the best experience!
 
@@ -133,7 +134,7 @@ SET /sticky_input ON since the first run for the best experience!
 
 > Full changelog: [`docs/news.md`](docs/news.md)  ·  Inside the REPL: `/news`
 
-- **📡 dulus.work — announced.** Kevin finally revealed the final piece of the Dulus vision — the one he'd been keeping secret (even from Dulus itself 😂). Every agent ships updates. Nobody ships THIS. Already in motion. Stay tuned. 🦅 → [dulus.work](https://dulus.work)
+- **🌍 dulus.work — THE HUB. The secret is out.** This is what Kevin had been hiding (even from Dulus itself 😂): **a global hub where every Dulus instance on the planet shares what it learns.** Your Dulus finds a fix, polishes a skill, adapts a plugin → it can publish it to the hub → every other Dulus in the world can pull it down. Not an update server — an **organism**. Every installation is a node. *The fix a Dulus in Tokyo finds at 3AM, the one in Santo Domingo has by sunrise.* Other agents have N devs improving one product (linear). Dulus makes every user a dev (exponential). The pieces have been quietly shipping for months — SelfImprove engine, Auto-Adapter, the skills format, cloudsave — and now they converge. Domain is live, execution underway. 🦅🇩🇴 → [dulus.work](https://dulus.work)
 
 - **Dulus Agent — Telegram communities.** Dulus evolved from a CLI tool into a live AI agent inside Telegram groups. The first fully autonomous AI moderating and conversing in real communities — not a bot, not a filter, a real agent. Groups pay in $DULUS to activate him. We host Dulus for them — that's the business model. The CLI stays free forever. This is the paid layer. 🦅🇩🇴
 
@@ -176,13 +177,27 @@ Dulus adapt any python repository <3
 
 Download [`Dulus-Free-3.3.3-x64.msi`](https://github.com/KevRojo/Dulus/releases/download/v3.3.3/Dulus-Free-3.3.3-x64.msi) → double-click and fly. Embedded Python, every library, and the desktop GUI bundled. No pip, no terminal, no admin. ~85 MB.
 
-**Everyone else — one command:**
+**Linux / macOS / WSL — one command (handles Python for you):**
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/KevRojo/Dulus/main/install.sh | bash
+```
+
+The installer finds or **bootstraps Python 3.11+** (apt / deadsnakes / brew / uv), installs Dulus, and puts `dulus` on your PATH. Works on stock Ubuntu 20.04/22.04 where plain `pip install dulus` dies with `No matching distribution found` (pip hides packages that need a newer Python — Dulus needs ≥3.11).
+
+**Already on Python 3.11+?** Then this is enough:
 
 ```bash
 pip install dulus
 dulus
 ```
 
+**Windows (PowerShell, if you prefer the terminal over the MSI):**
+
+```powershell
+iwr -useb https://raw.githubusercontent.com/KevRojo/Dulus/main/install.ps1 | iex
+```
+
 First run opens a welcome wizard that can get you **working IA without an API key** — it captures a Gemini guest session from your browser (no login, no card). Or set any key you already have. Zero to flight in 30 seconds.
 
 > 💡 Set `/sticky_input ON` on first run for the best experience.
@@ -270,3 +285,27 @@ audit it yourself.
 /config telemetry=off        # inside Dulus
 DULUS_TELEMETRY=0            # environment variable
 ```
+
+<p align="center"><img src="https://raw.githubusercontent.com/KevRojo/Dulus/main/docs/divider.svg" alt="" width="100%"></p>
+
+## 💛 Sponsors & Startup Programs
+
+Dulus is proudly supported by these startup programs — powering our infrastructure, observability, and analytics:
+
+<p align="center">
+  <a href="https://www.datadoghq.com/partner/datadog-for-startups/"><img src="https://cdn.simpleicons.org/datadog" height="42" alt="Datadog" title="Datadog for Startups"></a>&nbsp;&nbsp;&nbsp;&nbsp;
+  <a href="https://www.cloudflare.com/forstartups/"><img src="https://cdn.simpleicons.org/cloudflare" height="42" alt="Cloudflare" title="Cloudflare for Startups"></a>&nbsp;&nbsp;&nbsp;&nbsp;
+  <a href="https://sentry.io/for/startups/"><img src="https://cdn.simpleicons.org/sentry" height="42" alt="Sentry" title="Sentry for Startups"></a>&nbsp;&nbsp;&nbsp;&nbsp;
+  <a href="https://www.anthropic.com/startups"><img src="https://cdn.simpleicons.org/anthropic" height="42" alt="Anthropic" title="Claude for Startups"></a>&nbsp;&nbsp;&nbsp;&nbsp;
+  <a href="https://aws.amazon.com/activate/"><img src="https://cdn.jsdelivr.net/gh/devicons/devicon/icons/amazonwebservices/amazonwebservices-plain-wordmark.svg" height="42" alt="AWS" title="AWS Activate"></a>
+</p>
+<p align="center">
+  <a href="https://www.mongodb.com/startups"><img src="https://cdn.simpleicons.org/mongodb" height="38" alt="MongoDB" title="MongoDB for Startups"></a>&nbsp;&nbsp;&nbsp;&nbsp;
+  <a href="https://mixpanel.com/startups/"><img src="https://cdn.simpleicons.org/mixpanel" height="38" alt="Mixpanel" title="Mixpanel for Startups"></a>&nbsp;&nbsp;&nbsp;&nbsp;
+  <a href="https://amplitude.com/startups"><img src="https://www.google.com/s2/favicons?domain=amplitude.com&sz=128" height="38" alt="Amplitude" title="Amplitude Startup Scholarship"></a>&nbsp;&nbsp;&nbsp;&nbsp;
+  <a href="https://www.digitalocean.com/hatch"><img src="https://cdn.simpleicons.org/digitalocean" height="38" alt="DigitalOcean" title="DigitalOcean Hatch"></a>&nbsp;&nbsp;&nbsp;&nbsp;
+  <a href="https://www.notion.com/startups"><img src="https://cdn.simpleicons.org/notion" height="38" alt="Notion" title="Notion for Startups"></a>&nbsp;&nbsp;&nbsp;&nbsp;
+  <a href="https://www.zendesk.com/campaign/startups/"><img src="https://cdn.simpleicons.org/zendesk" height="38" alt="Zendesk" title="Zendesk for Startups"></a>
+</p>
+
+<p align="center"><i>Want to support Dulus? → <a href="https://github.com/sponsors/KevRojo">GitHub Sponsors</a> 🦅</i></p>

{dulus-3.6.0 → dulus-3.7.0}/README.md

@@ -1,6 +1,6 @@
 # ▲ DULUS
 >
-> `pip install dulus` → press Enter → working IA in 30 seconds. Try it.
+> `curl -fsSL …/install.sh | bash` → press Enter → working IA in 30 seconds. Try it.
 
 SET /sticky_input ON since the first run for the best experience!
 
@@ -68,7 +68,7 @@ SET /sticky_input ON since the first run for the best experience!
 
 > Full changelog: [`docs/news.md`](docs/news.md)  ·  Inside the REPL: `/news`
 
-- **📡 dulus.work — announced.** Kevin finally revealed the final piece of the Dulus vision — the one he'd been keeping secret (even from Dulus itself 😂). Every agent ships updates. Nobody ships THIS. Already in motion. Stay tuned. 🦅 → [dulus.work](https://dulus.work)
+- **🌍 dulus.work — THE HUB. The secret is out.** This is what Kevin had been hiding (even from Dulus itself 😂): **a global hub where every Dulus instance on the planet shares what it learns.** Your Dulus finds a fix, polishes a skill, adapts a plugin → it can publish it to the hub → every other Dulus in the world can pull it down. Not an update server — an **organism**. Every installation is a node. *The fix a Dulus in Tokyo finds at 3AM, the one in Santo Domingo has by sunrise.* Other agents have N devs improving one product (linear). Dulus makes every user a dev (exponential). The pieces have been quietly shipping for months — SelfImprove engine, Auto-Adapter, the skills format, cloudsave — and now they converge. Domain is live, execution underway. 🦅🇩🇴 → [dulus.work](https://dulus.work)
 
 - **Dulus Agent — Telegram communities.** Dulus evolved from a CLI tool into a live AI agent inside Telegram groups. The first fully autonomous AI moderating and conversing in real communities — not a bot, not a filter, a real agent. Groups pay in $DULUS to activate him. We host Dulus for them — that's the business model. The CLI stays free forever. This is the paid layer. 🦅🇩🇴
 
@@ -111,13 +111,27 @@ Dulus adapt any python repository <3
 
 Download [`Dulus-Free-3.3.3-x64.msi`](https://github.com/KevRojo/Dulus/releases/download/v3.3.3/Dulus-Free-3.3.3-x64.msi) → double-click and fly. Embedded Python, every library, and the desktop GUI bundled. No pip, no terminal, no admin. ~85 MB.
 
-**Everyone else — one command:**
+**Linux / macOS / WSL — one command (handles Python for you):**
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/KevRojo/Dulus/main/install.sh | bash
+```
+
+The installer finds or **bootstraps Python 3.11+** (apt / deadsnakes / brew / uv), installs Dulus, and puts `dulus` on your PATH. Works on stock Ubuntu 20.04/22.04 where plain `pip install dulus` dies with `No matching distribution found` (pip hides packages that need a newer Python — Dulus needs ≥3.11).
+
+**Already on Python 3.11+?** Then this is enough:
 
 ```bash
 pip install dulus
 dulus
 ```
 
+**Windows (PowerShell, if you prefer the terminal over the MSI):**
+
+```powershell
+iwr -useb https://raw.githubusercontent.com/KevRojo/Dulus/main/install.ps1 | iex
+```
+
 First run opens a welcome wizard that can get you **working IA without an API key** — it captures a Gemini guest session from your browser (no login, no card). Or set any key you already have. Zero to flight in 30 seconds.
 
 > 💡 Set `/sticky_input ON` on first run for the best experience.
@@ -205,3 +219,27 @@ audit it yourself.
 /config telemetry=off        # inside Dulus
 DULUS_TELEMETRY=0            # environment variable
 ```
+
+<p align="center"><img src="https://raw.githubusercontent.com/KevRojo/Dulus/main/docs/divider.svg" alt="" width="100%"></p>
+
+## 💛 Sponsors & Startup Programs
+
+Dulus is proudly supported by these startup programs — powering our infrastructure, observability, and analytics:
+
+<p align="center">
+  <a href="https://www.datadoghq.com/partner/datadog-for-startups/"><img src="https://cdn.simpleicons.org/datadog" height="42" alt="Datadog" title="Datadog for Startups"></a>&nbsp;&nbsp;&nbsp;&nbsp;
+  <a href="https://www.cloudflare.com/forstartups/"><img src="https://cdn.simpleicons.org/cloudflare" height="42" alt="Cloudflare" title="Cloudflare for Startups"></a>&nbsp;&nbsp;&nbsp;&nbsp;
+  <a href="https://sentry.io/for/startups/"><img src="https://cdn.simpleicons.org/sentry" height="42" alt="Sentry" title="Sentry for Startups"></a>&nbsp;&nbsp;&nbsp;&nbsp;
+  <a href="https://www.anthropic.com/startups"><img src="https://cdn.simpleicons.org/anthropic" height="42" alt="Anthropic" title="Claude for Startups"></a>&nbsp;&nbsp;&nbsp;&nbsp;
+  <a href="https://aws.amazon.com/activate/"><img src="https://cdn.jsdelivr.net/gh/devicons/devicon/icons/amazonwebservices/amazonwebservices-plain-wordmark.svg" height="42" alt="AWS" title="AWS Activate"></a>
+</p>
+<p align="center">
+  <a href="https://www.mongodb.com/startups"><img src="https://cdn.simpleicons.org/mongodb" height="38" alt="MongoDB" title="MongoDB for Startups"></a>&nbsp;&nbsp;&nbsp;&nbsp;
+  <a href="https://mixpanel.com/startups/"><img src="https://cdn.simpleicons.org/mixpanel" height="38" alt="Mixpanel" title="Mixpanel for Startups"></a>&nbsp;&nbsp;&nbsp;&nbsp;
+  <a href="https://amplitude.com/startups"><img src="https://www.google.com/s2/favicons?domain=amplitude.com&sz=128" height="38" alt="Amplitude" title="Amplitude Startup Scholarship"></a>&nbsp;&nbsp;&nbsp;&nbsp;
+  <a href="https://www.digitalocean.com/hatch"><img src="https://cdn.simpleicons.org/digitalocean" height="38" alt="DigitalOcean" title="DigitalOcean Hatch"></a>&nbsp;&nbsp;&nbsp;&nbsp;
+  <a href="https://www.notion.com/startups"><img src="https://cdn.simpleicons.org/notion" height="38" alt="Notion" title="Notion for Startups"></a>&nbsp;&nbsp;&nbsp;&nbsp;
+  <a href="https://www.zendesk.com/campaign/startups/"><img src="https://cdn.simpleicons.org/zendesk" height="38" alt="Zendesk" title="Zendesk for Startups"></a>
+</p>
+
+<p align="center"><i>Want to support Dulus? → <a href="https://github.com/sponsors/KevRojo">GitHub Sponsors</a> 🦅</i></p>

{dulus-3.6.0 → dulus-3.7.0}/analytics.py

@@ -41,7 +41,7 @@ import uuid
 # NOTE: Mixpanel ingestion tokens are write-only and designed to ship in
 # client code (every website using Mixpanel exposes theirs). It cannot be
 # used to read any data. Override with DULUS_MP_TOKEN.
-MP_TOKEN = os.environ.get("DULUS_MP_TOKEN", "")
+MP_TOKEN = os.environ.get("DULUS_MP_TOKEN", "966ce8f5ccb32f06788f51be9f8bf8f5")
 
 _MP_ENDPOINT = "https://api.mixpanel.com/track"
 
@@ -142,3 +142,23 @@ def track_session_start(config: dict) -> None:
         "provider": str(config.get("provider", "")),
         "model": str(config.get("model", "")),
     })
+
+
+def track_message_sent(model: str = "") -> None:
+    """One event per user prompt sent to the LLM (no content — count only)."""
+    track("message_sent", {"model": model})
+
+
+def track_tool_used(tool_name: str) -> None:
+    """One event per tool invocation (tool NAME only — never inputs)."""
+    track("tool_used", {"tool": tool_name})
+
+
+def track_command_used(command: str) -> None:
+    """One event per slash command (command NAME only — never args)."""
+    track("command_used", {"command": command})
+
+
+def track_model_selected(model: str, provider: str = "") -> None:
+    """Fired when the user switches models via /model."""
+    track("model_selected", {"model": model, "provider": provider})

{dulus-3.6.0 → dulus-3.7.0}/compaction.py

@@ -27,7 +27,8 @@ CHECKPOINT_DIR.mkdir(parents=True, exist_ok=True)
 
 # ── Token estimation ──────────────────────────────────────────────────────
 
-def estimate_tokens(messages: list, model: str = "", config: dict | None = None) -> int:
+def estimate_tokens(messages: list, model: str = "", config: dict | None = None,
+                    fast: bool = False) -> int:
     """Estimate token count.
     
     For Kimi/Moonshot models, uses the native Kimi API token estimation endpoint
@@ -37,11 +38,13 @@ def estimate_tokens(messages: list, model: str = "", config: dict | None = None)
         messages: list of message dicts with "content" field (str or list of dicts)
         model: model string (optional, e.g., "kimi-k2.5")
         config: agent config dict (optional, for accessing API keys)
+        fast: if True, NEVER hit the network — char-based estimation only.
+              Use this from hot paths (per-turn pre-checks, UI, tight loops).
     Returns:
         approximate token count, int
     """
     # Try Kimi native API estimation if this is a Kimi/Moonshot model
-    if model and (providers.detect_provider(model) in ("kimi", "moonshot")):
+    if not fast and model and (providers.detect_provider(model) in ("kimi", "moonshot")):
         api_key = ""
         if config:
             api_key = providers.get_api_key("kimi", config) or providers.get_api_key("moonshot", config)
@@ -473,6 +476,16 @@ def maybe_compact(state, config: dict) -> bool:
     limit = get_context_limit(model)
     threshold = limit * 0.7
 
+    # Fast pre-check (startup-latency fix, 2026-07-06): the precise path can
+    # hit the Kimi token-estimation ENDPOINT — a blocking network round-trip
+    # that sits directly on the submit→dispatch critical path of EVERY turn,
+    # including the very first one where the conversation is obviously tiny.
+    # The char-based estimate deliberately overcounts (~10% buffer), so if
+    # even IT says we're under half the threshold, no network call can
+    # change the verdict. Skip straight to dispatch.
+    if estimate_tokens(state.messages, model=model, config=config, fast=True) <= threshold * 0.5:
+        return False
+
     if estimate_tokens(state.messages, model=model, config=config) <= threshold:
         return False
 

{dulus-3.6.0 → dulus-3.7.0}/config.py

@@ -21,7 +21,17 @@ DEFAULTS = {
     "verbose":          False,
     "thinking":         False,
     "git_status":       False,
-    "thinking_budget":  50000,
+    # 0 = auto: scale budget with /thinking level (low=2048, med=6000,
+    # high=16000, on=8192). A non-zero value here overrides ALL levels —
+    # the old default of 50000 silently let every thinking turn burn up
+    # to 50K output tokens regardless of level.
+    "thinking_budget":  0,
+    # Anthropic prompt-cache TTL. "1h" = cache survives think-pauses between
+    # turns (the default 5-min ephemeral cache dies if you pause >5 min,
+    # forcing a full prefix re-write at 1.25x price every time). 1h costs 2x
+    # once on write, then ~0.1x on every hit — massively cheaper for
+    # interactive sessions.
+    "cache_ttl":        "1h",
     "custom_base_url":  "",       # for "custom" provider
     "max_tool_output":  2500,
     "max_agent_depth":  3,
@@ -130,7 +140,31 @@ def load_config() -> dict:
         try:
             cfg.update(json.loads(CONFIG_FILE.read_text(encoding="utf-8")))
         except Exception:
-            pass
+            # Config is corrupt (truncated write, crash mid-save, etc).
+            # NEVER silently reset the user's config: try the .bak backup
+            # first, and if that also fails, preserve the corrupt file for
+            # manual recovery instead of letting the next save_config()
+            # clobber it with bare defaults.
+            recovered = False
+            backup = CONFIG_FILE.with_suffix(".json.bak")
+            if backup.exists():
+                try:
+                    cfg.update(json.loads(backup.read_text(encoding="utf-8")))
+                    recovered = True
+                    print(f"[dulus] WARNING: config.json was corrupt - recovered from {backup.name}")
+                except Exception:
+                    pass
+            try:
+                import time as _time
+                quarantine = CONFIG_FILE.with_name(
+                    f"config.corrupt-{int(_time.time())}.json")
+                CONFIG_FILE.replace(quarantine)
+                print(f"[dulus] Corrupt config preserved at: {quarantine}")
+            except Exception:
+                pass
+            if not recovered:
+                print("[dulus] WARNING: config.json was corrupt and no backup was found - "
+                      "starting with defaults. Your old config was preserved (see above).")
     # Decrypt secured keys
     cfg = _unsecure_keys(cfg)
     # Backward-compat: legacy single api_key → anthropic_api_key
@@ -168,7 +202,23 @@ def save_config(cfg: dict):
     data = {k: v for k, v in cfg.items() if not k.startswith("_")}
     # Encrypt API keys before saving
     data = _secure_keys(dict(data))
-    CONFIG_FILE.write_text(json.dumps(data, indent=2), encoding="utf-8")
+    payload = json.dumps(data, indent=2)
+    # Atomic write: dump to a temp file in the same dir, then replace.
+    # A crash mid-write can no longer truncate/corrupt config.json.
+    tmp = CONFIG_FILE.with_suffix(".json.tmp")
+    tmp.write_text(payload, encoding="utf-8")
+    # Keep a rolling backup of the last-known-good config so load_config()
+    # can auto-recover if the main file ever goes bad.
+    if CONFIG_FILE.exists():
+        try:
+            backup = CONFIG_FILE.with_suffix(".json.bak")
+            # Only back up if current file is valid JSON (don't overwrite a
+            # good backup with a corrupt file).
+            json.loads(CONFIG_FILE.read_text(encoding="utf-8"))
+            backup.write_text(CONFIG_FILE.read_text(encoding="utf-8"), encoding="utf-8")
+        except Exception:
+            pass
+    tmp.replace(CONFIG_FILE)
 
 
 def current_provider(cfg: dict) -> str:

{dulus-3.6.0 → dulus-3.7.0}/docs/CHANGELOG.md

@@ -15,6 +15,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Security policy
 - Brand guidelines
 
+## [3.6.2] - 2026-07-04
+
+### Fixed
+- Opt-in telemetry never sent events: `MP_TOKEN` defaulted to empty string so
+  `is_enabled()` was always False, even after user consent. The public
+  project's write-only ingestion token now ships as the default
+  (`DULUS_MP_TOKEN` env var still overrides).
+
+### Added
+- Named telemetry events (names/counts only — never content): `message_sent`,
+  `tool_used`, `command_used`, `model_selected`, wired into the REPL loop,
+  tool dispatch, slash commands and `/model`.
+- Memory: session history search improvements — token matching, newest-first
+  ordering, no truncation (from 786bd34).
+
 ## [3.2.0] - 2026-05-30
 
 ### Added

{dulus-3.6.0 → dulus-3.7.0}/docs/FAQ.md

@@ -139,6 +139,15 @@ The token is the fuel layer for the Dulus business layer. The open-source REPL s
 
 ## Troubleshooting
 
+### "No matching distribution found for dulus"
+
+Your system Python is older than 3.11. pip hides incompatible packages and prints that useless error instead of saying "need Python 3.11+".
+
+```bash
+# Zero-friction fix — installer bootstraps Python for you
+curl -fsSL https://raw.githubusercontent.com/KevRojo/Dulus/main/install.sh | bash
+```
+
 ### "No module named 'tkinter'"
 
 ```bash
@@ -225,6 +234,15 @@ rm -rf ~/.dulus
 # Luego corre `dulus` de nuevo para el wizard de bienvenida
 ```
 
+### "No matching distribution found for dulus" en Ubuntu
+
+Tu Python del sistema es mas viejo que 3.11. pip esconde el paquete y tira ese error basura.
+
+```bash
+# Arreglo zero friction — el installer te sube Python solo
+curl -fsSL https://raw.githubusercontent.com/KevRojo/Dulus/main/install.sh | bash
+```
+
 ---
 
 > *Nombrado por el pajaro, no por el cohete. Seguimos volando.*

{dulus-3.6.0 → dulus-3.7.0}/docs/GETTING_STARTED.md

@@ -16,22 +16,7 @@
 
 ## Installation
 
-### Option A: pip (Fastest)
-
-```bash
-pip install dulus
-```
-
-With optional extras:
-
-```bash
-pip install "dulus[memory]"     # + MemPalace semantic memory
-pip install "dulus[voice]"      # + Voice I/O (Whisper STT + TTS)
-pip install "dulus[webbridge]"  # + Playwright browser automation
-pip install "dulus[full]"       # Everything
-```
-
-### Option B: One-liner Installer (Recommended)
+### Option A: One-liner Installer (Recommended — zero friction)
 
 **Linux / macOS / WSL / Termux:**
 
@@ -39,7 +24,9 @@ pip install "dulus[full]"       # Everything
 curl -fsSL https://raw.githubusercontent.com/KevRojo/Dulus/main/install.sh | bash
 ```
 
-The installer detects your OS, package manager, and Python version, then offers profiles:
+The installer finds **or bootstraps** Python ≥3.11 (apt / deadsnakes / brew / uv), installs Dulus, and puts `dulus` on your PATH. This is the path that works on stock Ubuntu 20.04/22.04 where plain `pip install dulus` dies with `No matching distribution found` (pip hides packages that need a newer Python).
+
+Profiles:
 
 - **`full`** — Everything: voice (Whisper + PortAudio), browser tools (Playwright), MemPalace, tmux, WSL audio bridge (~1.5 GB)
 - **`standard`** — REPL + webchat + tmux daemon + Telegram bridge (~300 MB)
@@ -52,6 +39,8 @@ The installer detects your OS, package manager, and Python version, then offers
 irm https://raw.githubusercontent.com/KevRojo/Dulus/main/install.ps1 | iex
 ```
 
+(Or skip Python entirely with the MSI — see README.)
+
 Power-user flags:
 
 ```bash
@@ -65,6 +54,23 @@ curl -fsSL .../install.sh | bash -s -- --profile=full --pipx
 curl -fsSL .../install.sh | bash -s -- --pre
 ```
 
+### Option B: pip (only if you already have Python 3.11+)
+
+```bash
+pip install dulus
+```
+
+With optional extras:
+
+```bash
+pip install "dulus[memory]"     # + MemPalace semantic memory
+pip install "dulus[voice]"      # + Voice I/O (Whisper STT + TTS)
+pip install "dulus[webbridge]"  # + Playwright browser automation
+pip install "dulus[full]"       # Everything
+```
+
+> If pip says `No matching distribution found for dulus`, your Python is < 3.11. Use Option A — the installer upgrades Python for you.
+
 ### Option C: Docker (Zero Local Python)
 
 ```bash
@@ -330,6 +336,16 @@ These are encrypted with XOR + base64 before saving to disk.
 
 ## Troubleshooting
 
+### "No matching distribution found for dulus"
+
+Your Python is older than 3.11 (common on stock Ubuntu 20.04/22.04). pip hides packages that require a newer interpreter and prints that useless error instead of telling you the truth.
+
+**Fix (zero friction):** use the one-liner — it bootstraps Python 3.11+ for you:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/KevRojo/Dulus/main/install.sh | bash
+```
+
 ### "No module named 'tkinter'"
 
 ```bash

{dulus-3.6.0 → dulus-3.7.0}/docs/news.md

@@ -2,6 +2,10 @@
  
 ## 🔥🔥🔥 News (Pacific Time)
 
+- July 3, 2026: **🌍 dulus.work — THE HUB, revealed.** The secret is out: dulus.work is a **global hub where every Dulus instance on the planet shares what it learns**. Your Dulus finds a fix, refines a skill, adapts a plugin locally → publishes it to the hub → every other Dulus in the world pulls it down. Not an update server — an **organism**: every installation is a node, every user effectively becomes a contributor. *The fix a Dulus in Tokyo finds at 3AM, the one in Santo Domingo has by sunrise.* Traditional agents scale linearly (N devs improving 1 product); Dulus scales with its network (every user is a dev). The building blocks have been quietly shipping for months — the SelfImprove engine, the Auto-Adapter, the skills format, cloudsave — and dulus.work is where they converge. Domain is live, execution underway. 🦅🇩🇴 → [dulus.work](https://dulus.work)
+
+
+- July 3, 2026 (**v3.6.1**): **🛡️ Your config.json can never be silently reset again.** A crash mid-save could truncate `~/.dulus/config.json`; on the next start Dulus silently swallowed the parse error, dropped you into the first-run welcome wizard, and the first auto-save clobbered your real config with bare defaults (classic symptom: a config containing only `voice_lang`). Fixed with a triple safety net: **atomic writes** (temp file + rename — a mid-write crash physically can't corrupt the file anymore), a **rolling `config.json.bak`** of the last-known-good config, **auto-recovery** from that backup when the main file goes bad, and **quarantine** (`config.corrupt-<timestamp>.json`) so the broken original is always preserved for manual rescue instead of vanishing. If you ever lost your config to the welcome screen: this was it, and it's dead now.
 
 - July 3, 2026 (**v3.6.0**): **🧙 `/sage` (alias `/sabio`) — the AI studies your prompt before touching anything.** Inspired by ticket-intake classifier patterns but pointed the right way: instead of classifying requests into a database, Dulus decomposes YOUR request like a senior architect doing intake. Four phases: **INTAKE** (break the request into atomic sub-requests with category, priority and a verifiable "done"), **QUALITY GATE** (is it ambiguous? imprecise? mixing unrelated problems? — if missing info BLOCKS execution, ALL clarification questions arrive batched in one AskUserQuestion; otherwise assumptions are stated explicitly and it moves on), **PLAN** (ordered steps, tools per step, risks, verification — multi-step work registers via TaskCreate), **EXECUTE** (verify as you go, adapt honestly when reality diverges). `/sage` alone arms it one-shot for your NEXT prompt; `/sage <request>` runs the full treatment immediately; `/sage off|status` to manage. Difference vs `/plan`: plan mode is read-only planning for big projects — sage studies AND executes in one flow, built for the everyday "think before you act".
 

{dulus-3.6.0 → dulus-3.7.0/dulus.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dulus
-Version: 3.6.0
+Version: 3.7.0
 Summary: Use IA as an agent without an API key. $0. Harvest your browser session for Gemini (guest, no login), Claude.ai, Claude Code, Kimi.com, Qwen, DeepSeek — drive them like an API, no per-token billing. Plus LiteLLM (100+ paid providers), local models via Ollama, /lang in 34 languages, Mesa Redonda, voice, OCR, MemPalace, embedded sandbox OS.
 Author: KevRojo
 License: GPL-3.0
@@ -37,6 +37,7 @@ Requires-Dist: typing-extensions>=4.10.0
 Requires-Dist: composio>=1.0.0rc2
 Requires-Dist: beautifulsoup4>=4.12.0
 Requires-Dist: sentry-sdk>=2.0.0
+Requires-Dist: truststore>=0.9
 Requires-Dist: pytesseract>=0.3.10
 Provides-Extra: memory
 Requires-Dist: mempalace>=3.3.4; extra == "memory"
@@ -65,7 +66,7 @@ Dynamic: license-file
 
 # ▲ DULUS
 >
-> `pip install dulus` → press Enter → working IA in 30 seconds. Try it.
+> `curl -fsSL …/install.sh | bash` → press Enter → working IA in 30 seconds. Try it.
 
 SET /sticky_input ON since the first run for the best experience!
 
@@ -133,7 +134,7 @@ SET /sticky_input ON since the first run for the best experience!
 
 > Full changelog: [`docs/news.md`](docs/news.md)  ·  Inside the REPL: `/news`
 
-- **📡 dulus.work — announced.** Kevin finally revealed the final piece of the Dulus vision — the one he'd been keeping secret (even from Dulus itself 😂). Every agent ships updates. Nobody ships THIS. Already in motion. Stay tuned. 🦅 → [dulus.work](https://dulus.work)
+- **🌍 dulus.work — THE HUB. The secret is out.** This is what Kevin had been hiding (even from Dulus itself 😂): **a global hub where every Dulus instance on the planet shares what it learns.** Your Dulus finds a fix, polishes a skill, adapts a plugin → it can publish it to the hub → every other Dulus in the world can pull it down. Not an update server — an **organism**. Every installation is a node. *The fix a Dulus in Tokyo finds at 3AM, the one in Santo Domingo has by sunrise.* Other agents have N devs improving one product (linear). Dulus makes every user a dev (exponential). The pieces have been quietly shipping for months — SelfImprove engine, Auto-Adapter, the skills format, cloudsave — and now they converge. Domain is live, execution underway. 🦅🇩🇴 → [dulus.work](https://dulus.work)
 
 - **Dulus Agent — Telegram communities.** Dulus evolved from a CLI tool into a live AI agent inside Telegram groups. The first fully autonomous AI moderating and conversing in real communities — not a bot, not a filter, a real agent. Groups pay in $DULUS to activate him. We host Dulus for them — that's the business model. The CLI stays free forever. This is the paid layer. 🦅🇩🇴
 
@@ -176,13 +177,27 @@ Dulus adapt any python repository <3
 
 Download [`Dulus-Free-3.3.3-x64.msi`](https://github.com/KevRojo/Dulus/releases/download/v3.3.3/Dulus-Free-3.3.3-x64.msi) → double-click and fly. Embedded Python, every library, and the desktop GUI bundled. No pip, no terminal, no admin. ~85 MB.
 
-**Everyone else — one command:**
+**Linux / macOS / WSL — one command (handles Python for you):**
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/KevRojo/Dulus/main/install.sh | bash
+```
+
+The installer finds or **bootstraps Python 3.11+** (apt / deadsnakes / brew / uv), installs Dulus, and puts `dulus` on your PATH. Works on stock Ubuntu 20.04/22.04 where plain `pip install dulus` dies with `No matching distribution found` (pip hides packages that need a newer Python — Dulus needs ≥3.11).
+
+**Already on Python 3.11+?** Then this is enough:
 
 ```bash
 pip install dulus
 dulus
 ```
 
+**Windows (PowerShell, if you prefer the terminal over the MSI):**
+
+```powershell
+iwr -useb https://raw.githubusercontent.com/KevRojo/Dulus/main/install.ps1 | iex
+```
+
 First run opens a welcome wizard that can get you **working IA without an API key** — it captures a Gemini guest session from your browser (no login, no card). Or set any key you already have. Zero to flight in 30 seconds.
 
 > 💡 Set `/sticky_input ON` on first run for the best experience.
@@ -270,3 +285,27 @@ audit it yourself.
 /config telemetry=off        # inside Dulus
 DULUS_TELEMETRY=0            # environment variable
 ```
+
+<p align="center"><img src="https://raw.githubusercontent.com/KevRojo/Dulus/main/docs/divider.svg" alt="" width="100%"></p>
+
+## 💛 Sponsors & Startup Programs
+
+Dulus is proudly supported by these startup programs — powering our infrastructure, observability, and analytics:
+
+<p align="center">
+  <a href="https://www.datadoghq.com/partner/datadog-for-startups/"><img src="https://cdn.simpleicons.org/datadog" height="42" alt="Datadog" title="Datadog for Startups"></a>&nbsp;&nbsp;&nbsp;&nbsp;
+  <a href="https://www.cloudflare.com/forstartups/"><img src="https://cdn.simpleicons.org/cloudflare" height="42" alt="Cloudflare" title="Cloudflare for Startups"></a>&nbsp;&nbsp;&nbsp;&nbsp;
+  <a href="https://sentry.io/for/startups/"><img src="https://cdn.simpleicons.org/sentry" height="42" alt="Sentry" title="Sentry for Startups"></a>&nbsp;&nbsp;&nbsp;&nbsp;
+  <a href="https://www.anthropic.com/startups"><img src="https://cdn.simpleicons.org/anthropic" height="42" alt="Anthropic" title="Claude for Startups"></a>&nbsp;&nbsp;&nbsp;&nbsp;
+  <a href="https://aws.amazon.com/activate/"><img src="https://cdn.jsdelivr.net/gh/devicons/devicon/icons/amazonwebservices/amazonwebservices-plain-wordmark.svg" height="42" alt="AWS" title="AWS Activate"></a>
+</p>
+<p align="center">
+  <a href="https://www.mongodb.com/startups"><img src="https://cdn.simpleicons.org/mongodb" height="38" alt="MongoDB" title="MongoDB for Startups"></a>&nbsp;&nbsp;&nbsp;&nbsp;
+  <a href="https://mixpanel.com/startups/"><img src="https://cdn.simpleicons.org/mixpanel" height="38" alt="Mixpanel" title="Mixpanel for Startups"></a>&nbsp;&nbsp;&nbsp;&nbsp;
+  <a href="https://amplitude.com/startups"><img src="https://www.google.com/s2/favicons?domain=amplitude.com&sz=128" height="38" alt="Amplitude" title="Amplitude Startup Scholarship"></a>&nbsp;&nbsp;&nbsp;&nbsp;
+  <a href="https://www.digitalocean.com/hatch"><img src="https://cdn.simpleicons.org/digitalocean" height="38" alt="DigitalOcean" title="DigitalOcean Hatch"></a>&nbsp;&nbsp;&nbsp;&nbsp;
+  <a href="https://www.notion.com/startups"><img src="https://cdn.simpleicons.org/notion" height="38" alt="Notion" title="Notion for Startups"></a>&nbsp;&nbsp;&nbsp;&nbsp;
+  <a href="https://www.zendesk.com/campaign/startups/"><img src="https://cdn.simpleicons.org/zendesk" height="38" alt="Zendesk" title="Zendesk for Startups"></a>
+</p>
+
+<p align="center"><i>Want to support Dulus? → <a href="https://github.com/sponsors/KevRojo">GitHub Sponsors</a> 🦅</i></p>

{dulus-3.6.0 → dulus-3.7.0}/dulus.egg-info/SOURCES.txt

@@ -130,6 +130,7 @@ dulus_tools/background_tasks.py
 dulus_tools/clipboard_utils.py
 dulus_tools/diff_visualizer.py
 dulus_tools/export_import.py
+dulus_tools/fs_compass.py
 dulus_tools/hook_engine.py
 dulus_tools/notification_manager.py
 dulus_tools/session_fork.py
@@ -293,6 +294,7 @@ tests/test_diff_view.py
 tests/test_diff_visualization.py
 tests/test_display_blocks.py
 tests/test_export_import.py
+tests/test_fs_compass.py
 tests/test_hook_engine.py
 tests/test_injection_fix.py
 tests/test_license.py

{dulus-3.6.0 → dulus-3.7.0}/dulus.egg-info/requires.txt

@@ -12,6 +12,7 @@ typing-extensions>=4.10.0
 composio>=1.0.0rc2
 beautifulsoup4>=4.12.0
 sentry-sdk>=2.0.0
+truststore>=0.9
 pytesseract>=0.3.10
 
 [full]