dulus 3.3.4__tar.gz → 3.5.0__tar.gz

{dulus-3.3.4 → dulus-3.5.0}/MANIFEST.in

@@ -2,6 +2,9 @@ include pyproject.toml
 recursive-include docs *
 recursive-include data *
 recursive-include sandbox/dist *
+recursive-include gui/dulus_orchestrator/dist *
+exclude gui/dulus_orchestrator/dist/runtime-state.js
+exclude gui/dulus_orchestrator/dist/desktop-pet.html
 recursive-include webbridge *
 global-exclude __pycache__/*
 global-exclude *.pyc

dulus-3.5.0/PKG-INFO

@@ -0,0 +1,272 @@
+Metadata-Version: 2.4
+Name: dulus
+Version: 3.5.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
+Project-URL: Homepage, https://github.com/KevRojo/Dulus
+Project-URL: Repository, https://github.com/KevRojo/Dulus
+Project-URL: Issues, https://github.com/KevRojo/Dulus/issues
+Keywords: ai,cli,llm,claude,gemini,nvidia,openai,kimi,deepseek,qwen,ollama,agent,tts,voice
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Terminals
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: license_manager.py
+Requires-Dist: anthropic>=0.40.0
+Requires-Dist: openai>=1.30.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: prompt_toolkit>=3.0.0
+Requires-Dist: Flask>=3.1.3
+Requires-Dist: bubblewrap-cli>=1.0.0
+Requires-Dist: customtkinter>=5.2.0
+Requires-Dist: Pillow>=10.0.0
+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: pytesseract>=0.3.10
+Provides-Extra: memory
+Requires-Dist: mempalace>=3.3.4; extra == "memory"
+Provides-Extra: voice
+Requires-Dist: sounddevice; extra == "voice"
+Requires-Dist: elevenlabs>=1.0.0; extra == "voice"
+Provides-Extra: webbridge
+Requires-Dist: playwright>=1.40.0; extra == "webbridge"
+Provides-Extra: litellm
+Requires-Dist: litellm>=1.50.0; extra == "litellm"
+Provides-Extra: ocr
+Requires-Dist: pytesseract>=0.3.10; extra == "ocr"
+Requires-Dist: Pillow>=10.0.0; extra == "ocr"
+Provides-Extra: ocr-deep
+Requires-Dist: pytesseract>=0.3.10; extra == "ocr-deep"
+Requires-Dist: Pillow>=10.0.0; extra == "ocr-deep"
+Requires-Dist: easyocr>=1.7.0; extra == "ocr-deep"
+Provides-Extra: full
+Requires-Dist: mempalace>=3.3.4; extra == "full"
+Requires-Dist: sounddevice; extra == "full"
+Requires-Dist: elevenlabs>=1.0.0; extra == "full"
+Requires-Dist: playwright>=1.40.0; extra == "full"
+Requires-Dist: litellm>=1.50.0; extra == "full"
+Requires-Dist: pytesseract>=0.3.10; extra == "full"
+Dynamic: license-file
+
+# ▲ DULUS
+>
+> `pip install dulus` → press Enter → working IA in 30 seconds. Try it.
+
+SET /sticky_input ON since the first run for the best experience!
+
+<p align="center">
+  
+  <img width="700" height="665" alt="mascot-hero" src="https://github.com/user-attachments/assets/8b122834-552c-4bd4-b46d-3e17deb74ab5" />
+
+</p>
+
+<p align="center"><i>The Dulus (Cigua Palmera) — Dominican national bird. Named after the bird, not the rocket.</i></p>
+
+<p align="center">
+  <a href="#quick-start"><b>Quick Start</b></a> ·
+  <a href="#models"><b>Models</b></a> ·
+  <a href="#features"><b>Features</b></a> ·
+  <a href="#permissions"><b>Permissions</b></a> ·
+  <a href="#mcp"><b>MCP</b></a> ·
+  <a href="#plugins"><b>Plugins</b></a>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/dulus/"><img src="https://img.shields.io/pypi/v/dulus.svg?style=flat-square&color=ff6b1f&labelColor=07070a&label=pypi" alt="pypi"/></a>
+  <a href="https://pypi.org/project/dulus/"><img src="https://static.pepy.tech/badge/dulus?style=flat-square" alt="downloads"/></a>
+  <img src="https://img.shields.io/badge/python-3.11+-ff6b1f?style=flat-square&labelColor=07070a" alt="python"/>
+  <img src="https://img.shields.io/badge/license-GPLv3-ff6b1f?style=flat-square&labelColor=07070a" alt="license"/>
+  <img src="https://img.shields.io/badge/version-v3.3.3-ff6b1f?style=flat-square&labelColor=07070a" alt="version"/>
+  <img src="https://img.shields.io/badge/providers-100%2B%20via%20LiteLLM-ff6b1f?style=flat-square&labelColor=07070a" alt="providers"/>
+  <img src="https://img.shields.io/badge/tools-30%2B-ff6b1f?style=flat-square&labelColor=07070a" alt="tools"/>
+  <img src="https://img.shields.io/badge/tests-263+-ff6b1f?style=flat-square&labelColor=07070a" alt="tests"/>
+  <a href="https://x.com/KevRojo"><img src="https://img.shields.io/badge/x-%40KevRojo-ff6b1f?style=flat-square&labelColor=07070a&logo=x" alt="x"/></a>
+</p>
+
+<p align="center">
+  🌐 <b>Multilingual</b> ·
+  <a href="docs/README_EN.md">English</a> ·
+  <a href="docs/README_ES.md">Español</a> ·
+  <a href="docs/README_FR.md">Français</a> ·
+  <a href="docs/README_ZH.md">中文</a> ·
+  <a href="docs/README_JA.md">日本語</a> ·
+  <a href="docs/README_KO.md">한국어</a> ·
+  <a href="docs/README_PT.md">Português</a> ·
+  <a href="docs/README_RU.md">Русский</a> ·
+  <a href="docs/README_AR.md">العربية</a>
+</p>
+
+> **Official X / creator handle:** [@KevRojo](https://x.com/KevRojo) — that's me, the only contributor to this repo. Any other account claiming to be Dulus is a copycat.
+>
+> **$DULUS AI token  Solana):** [`9R8rrjXxcfQPmLTCLhmVpjr2uesjjkcgkinE6Lwdpump`](https://dexscreener.com/solana/9R8rrjXxcfQPmLTCLhmVpjr2uesjjkcgkinE6Lwdpump)
+
+-----
+<p align="center">
+  <code>pip install dulus</code>
+</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/KevRojo/Dulus/main/docs/divider.svg" alt="" width="100%"></p>
+
+<p align="center">
+  <a href="https://dulus.ai/"><b>🌐 Visit the Dulus website →</b></a><br>
+  <sub>The site covers features, demos, and details not documented in this README.</sub>
+</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/KevRojo/Dulus/main/docs/divider.svg" alt="" width="100%"></p>
+
+## 🔥 What's new
+
+> 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 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. 🦅🇩🇴
+
+- **v0.2.93 — IA WITHOUT AN API KEY, FIRST-RUN.** 🦅 The welcome wizard now offers, by default, to open Gemini in a browser and capture its **guest session** — no Google login, no API key, no credit card. From `pip install` to working IA in 30 seconds. Same flow works for Claude.ai / Kimi.com / Qwen / DeepSeek if you have those accounts. This was Dulus's ace under the sleeve. Now it's the front door.
+- **v0.2.92** — **`/lang` command.** 34 ISO codes + free-form descriptors. `/lang zh`, `/lang ja`, `/lang pt-br`, `/lang "speak as my gym tutor"`, `/lang "tigre de calle dominicano"`, `/lang "Yoda"`. The model role-plays the voice across the whole session. Triggered after Doubao (China's biggest IA assistant) started referring traffic to the repo.
+- **v0.2.91** — **CORS on the daemon.** The Android Sandbox APK now connects every app live — same daemon, finally cross-origin reachable.
+- **v0.2.89** — **Sandbox embedded INSIDE the desktop GUI.** Click `🦅 Sandbox` in the GUI Web tab → the Dulus OS renders inside the content frame via pywebview subprocess + Win32 `SetParent` reparent. Not a popup. Inside the frame.
+- **v0.2.89** — **Local OCR shipped first-class.** `/ocr` + `ExtractTextFromImage` tool, `WebBridgeScreenshot` auto-OCRs, `/img` sends image + verbatim OCR text together. Zero vision-model tokens for receipts / code screenshots / error stacks.
+- **v0.2.89** — **`kepano/obsidian-skills` bundled.** Dulus writes Obsidian-flavored markdown by default. Open `~/.dulus/memory/` as an Obsidian vault → instant graph view.
+- **v0.2.88** — **LiteLLM gateway: one provider entry, 100+ backends.** OpenRouter, Groq, Together, Bedrock, Vertex, Cohere, Perplexity, xAI, Mistral, Fireworks, Anyscale, Replicate, Azure, DeepInfra — the welcome wizard auto-installs the package and asks for the right per-backend key.
+- **v0.2.85** — **Slim wheel 11.4 MB → 2.5 MB.** Smaller than the original baseline.
+
+<p align="center"><img src="https://raw.githubusercontent.com/KevRojo/Dulus/main/docs/divider.svg" alt="" width="100%"></p>
+
+## What is this
+
+Dulus Reduce your IA costs by 60% parsing webchats and claude-code directly. Write poetry while Anthropic only see text.
+Use claude-code as an API without the new 'extra-usage' wall <3
+
+
+Another reminder of a Dulus magic spell: 
+Wanna get stock prices, history , etc? 
+
+/plugin install yfinance@https://github.com/ranaroussi/yfinance
+
+them:
+/plugin reload
+
+dulus get the prices of NVDA, TSLA, SP500:
+
+Be creative!!! 
+
+Dulus adapt any python repository <3
+
+<p align="center"><img src="https://raw.githubusercontent.com/KevRojo/Dulus/main/docs/divider.svg" alt="" width="100%"></p>
+
+## Quick Start
+
+**Windows — no Python needed (1-click):**
+
+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:**
+
+```bash
+pip install dulus
+dulus
+```
+
+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.
+
+## Models
+
+Speak every dialect — switch mid-session with `/model`:
+
+| Kind | Providers |
+|---|---|
+| **Cloud** | Anthropic · OpenAI · Gemini · DeepSeek · Kimi · Qwen · Zhipu · MiniMax |
+| **Free tier** | **14 frontier models via NVIDIA NIM** — 40 RPM each, $0. Key at [build.nvidia.com](https://build.nvidia.com) |
+| **Gateway** | 100+ backends via LiteLLM — OpenRouter, Groq, Together, Bedrock, Vertex, xAI, Mistral... |
+| **Web chats** | Use the chats you **already pay for**: Claude.ai, Gemini, Kimi.com, Qwen, DeepSeek — parsed as providers |
+| **Local** | Ollama · LM Studio · any OpenAI-compatible endpoint. Runs offline, completely. |
+
+## Features
+
+The full tour lives on [the website](https://dulus.ai/) — highlights:
+
+- **27 built-in tools** — Read/Write/Edit, Bash, Glob/Grep, WebFetch/WebSearch, NotebookEdit, GetDiagnostics, Memory, Tasks, Agents, Skills...
+- **Sub-agents** — typed agents (coder, reviewer, researcher, tester), each in its own git worktree, talking via message passing
+- **Persistent memory + checkpoints** — never lose context. Ever. Open `~/.dulus/memory/` as an Obsidian vault
+- **Dulus OS** — not a CLI, a workstation for the agent (sandbox desktop in your browser)
+- **Voice** — offline Whisper STT, no API key, no cloud. Wake words included
+- **Brainstorm Mode** — multi-persona AI debate. Council of ghosts
+- **SSJ Developer Mode** — ten chained workflow shortcuts behind one keystroke: refactor → review → test → commit → ship
+- **Telegram bridge** — slash commands, vision, and voice from your phone
+- **Local OCR** — `/ocr`, `/img` with verbatim text extraction, zero vision tokens
+- **Plan mode, webchat UI, desktop GUI, task manager...** — [see the site](https://dulus.ai/)
+
+## Permissions
+
+Three modes, switchable any time with `/permissions [mode]`:
+
+| Mode | Behavior |
+|---|---|
+| `auto` (default) | Safe tools run free; risky actions (writes, shell) ask first |
+| `manual` | Everything asks |
+| `accept-all` | Never asks — YOLO. Also via `dulus --accept-all` |
+
+Answering `a` at any prompt upgrades the session to accept-all.
+
+## MCP
+
+Drop a `.mcp.json` in your project — every server registers instantly as `mcp__server__tool`. stdio, SSE, and HTTP transports.
+
+```
+/mcp                        # list servers and their tools
+/mcp add <name> <cmd>       # add a stdio server
+/mcp reload                 # reconnect all
+```
+
+## Plugins
+
+The **Auto-Adapter** onboards *any* Python repo as native tools — zero manifest, hot-reload, no restart:
+
+```
+/plugin install yfinance@https://github.com/ranaroussi/yfinance
+/plugin reload
+```
+
+Then just ask: *"dulus get the prices of NVDA, TSLA, SP500"*. Be creative — 800+ ready-made skills via Composio too.
+
+<p align="center"><img src="https://raw.githubusercontent.com/KevRojo/Dulus/main/docs/divider.svg" alt="" width="100%"></p>
+
+## 🔒 Privacy & anonymous telemetry (opt-in)
+
+On first launch Dulus asks **once** if you'd like to share anonymous usage
+statistics. **Nothing is sent unless you say yes.**
+
+| Collected (if you opt in) | NEVER collected |
+|---|---|
+| Event names (`session_start`, `tool_used`, `model_selected`) | Prompts or responses |
+| Dulus version, OS name, Python version | File contents or paths |
+| Provider/model names (e.g. `gemini`) | API keys or tokens |
+| A random anonymous ID generated on your machine | Emails, usernames, IPs (geo disabled) |
+
+Data goes to [Mixpanel](https://mixpanel.com) (event analytics). The full
+implementation is ~140 lines of readable code in [`analytics.py`](analytics.py) —
+audit it yourself.
+
+**Opt out anytime:**
+```
+/config telemetry=off        # inside Dulus
+DULUS_TELEMETRY=0            # environment variable
+```

dulus-3.5.0/README.md

@@ -0,0 +1,207 @@
+# ▲ DULUS
+>
+> `pip install dulus` → press Enter → working IA in 30 seconds. Try it.
+
+SET /sticky_input ON since the first run for the best experience!
+
+<p align="center">
+  
+  <img width="700" height="665" alt="mascot-hero" src="https://github.com/user-attachments/assets/8b122834-552c-4bd4-b46d-3e17deb74ab5" />
+
+</p>
+
+<p align="center"><i>The Dulus (Cigua Palmera) — Dominican national bird. Named after the bird, not the rocket.</i></p>
+
+<p align="center">
+  <a href="#quick-start"><b>Quick Start</b></a> ·
+  <a href="#models"><b>Models</b></a> ·
+  <a href="#features"><b>Features</b></a> ·
+  <a href="#permissions"><b>Permissions</b></a> ·
+  <a href="#mcp"><b>MCP</b></a> ·
+  <a href="#plugins"><b>Plugins</b></a>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/dulus/"><img src="https://img.shields.io/pypi/v/dulus.svg?style=flat-square&color=ff6b1f&labelColor=07070a&label=pypi" alt="pypi"/></a>
+  <a href="https://pypi.org/project/dulus/"><img src="https://static.pepy.tech/badge/dulus?style=flat-square" alt="downloads"/></a>
+  <img src="https://img.shields.io/badge/python-3.11+-ff6b1f?style=flat-square&labelColor=07070a" alt="python"/>
+  <img src="https://img.shields.io/badge/license-GPLv3-ff6b1f?style=flat-square&labelColor=07070a" alt="license"/>
+  <img src="https://img.shields.io/badge/version-v3.3.3-ff6b1f?style=flat-square&labelColor=07070a" alt="version"/>
+  <img src="https://img.shields.io/badge/providers-100%2B%20via%20LiteLLM-ff6b1f?style=flat-square&labelColor=07070a" alt="providers"/>
+  <img src="https://img.shields.io/badge/tools-30%2B-ff6b1f?style=flat-square&labelColor=07070a" alt="tools"/>
+  <img src="https://img.shields.io/badge/tests-263+-ff6b1f?style=flat-square&labelColor=07070a" alt="tests"/>
+  <a href="https://x.com/KevRojo"><img src="https://img.shields.io/badge/x-%40KevRojo-ff6b1f?style=flat-square&labelColor=07070a&logo=x" alt="x"/></a>
+</p>
+
+<p align="center">
+  🌐 <b>Multilingual</b> ·
+  <a href="docs/README_EN.md">English</a> ·
+  <a href="docs/README_ES.md">Español</a> ·
+  <a href="docs/README_FR.md">Français</a> ·
+  <a href="docs/README_ZH.md">中文</a> ·
+  <a href="docs/README_JA.md">日本語</a> ·
+  <a href="docs/README_KO.md">한국어</a> ·
+  <a href="docs/README_PT.md">Português</a> ·
+  <a href="docs/README_RU.md">Русский</a> ·
+  <a href="docs/README_AR.md">العربية</a>
+</p>
+
+> **Official X / creator handle:** [@KevRojo](https://x.com/KevRojo) — that's me, the only contributor to this repo. Any other account claiming to be Dulus is a copycat.
+>
+> **$DULUS AI token  Solana):** [`9R8rrjXxcfQPmLTCLhmVpjr2uesjjkcgkinE6Lwdpump`](https://dexscreener.com/solana/9R8rrjXxcfQPmLTCLhmVpjr2uesjjkcgkinE6Lwdpump)
+
+-----
+<p align="center">
+  <code>pip install dulus</code>
+</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/KevRojo/Dulus/main/docs/divider.svg" alt="" width="100%"></p>
+
+<p align="center">
+  <a href="https://dulus.ai/"><b>🌐 Visit the Dulus website →</b></a><br>
+  <sub>The site covers features, demos, and details not documented in this README.</sub>
+</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/KevRojo/Dulus/main/docs/divider.svg" alt="" width="100%"></p>
+
+## 🔥 What's new
+
+> 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 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. 🦅🇩🇴
+
+- **v0.2.93 — IA WITHOUT AN API KEY, FIRST-RUN.** 🦅 The welcome wizard now offers, by default, to open Gemini in a browser and capture its **guest session** — no Google login, no API key, no credit card. From `pip install` to working IA in 30 seconds. Same flow works for Claude.ai / Kimi.com / Qwen / DeepSeek if you have those accounts. This was Dulus's ace under the sleeve. Now it's the front door.
+- **v0.2.92** — **`/lang` command.** 34 ISO codes + free-form descriptors. `/lang zh`, `/lang ja`, `/lang pt-br`, `/lang "speak as my gym tutor"`, `/lang "tigre de calle dominicano"`, `/lang "Yoda"`. The model role-plays the voice across the whole session. Triggered after Doubao (China's biggest IA assistant) started referring traffic to the repo.
+- **v0.2.91** — **CORS on the daemon.** The Android Sandbox APK now connects every app live — same daemon, finally cross-origin reachable.
+- **v0.2.89** — **Sandbox embedded INSIDE the desktop GUI.** Click `🦅 Sandbox` in the GUI Web tab → the Dulus OS renders inside the content frame via pywebview subprocess + Win32 `SetParent` reparent. Not a popup. Inside the frame.
+- **v0.2.89** — **Local OCR shipped first-class.** `/ocr` + `ExtractTextFromImage` tool, `WebBridgeScreenshot` auto-OCRs, `/img` sends image + verbatim OCR text together. Zero vision-model tokens for receipts / code screenshots / error stacks.
+- **v0.2.89** — **`kepano/obsidian-skills` bundled.** Dulus writes Obsidian-flavored markdown by default. Open `~/.dulus/memory/` as an Obsidian vault → instant graph view.
+- **v0.2.88** — **LiteLLM gateway: one provider entry, 100+ backends.** OpenRouter, Groq, Together, Bedrock, Vertex, Cohere, Perplexity, xAI, Mistral, Fireworks, Anyscale, Replicate, Azure, DeepInfra — the welcome wizard auto-installs the package and asks for the right per-backend key.
+- **v0.2.85** — **Slim wheel 11.4 MB → 2.5 MB.** Smaller than the original baseline.
+
+<p align="center"><img src="https://raw.githubusercontent.com/KevRojo/Dulus/main/docs/divider.svg" alt="" width="100%"></p>
+
+## What is this
+
+Dulus Reduce your IA costs by 60% parsing webchats and claude-code directly. Write poetry while Anthropic only see text.
+Use claude-code as an API without the new 'extra-usage' wall <3
+
+
+Another reminder of a Dulus magic spell: 
+Wanna get stock prices, history , etc? 
+
+/plugin install yfinance@https://github.com/ranaroussi/yfinance
+
+them:
+/plugin reload
+
+dulus get the prices of NVDA, TSLA, SP500:
+
+Be creative!!! 
+
+Dulus adapt any python repository <3
+
+<p align="center"><img src="https://raw.githubusercontent.com/KevRojo/Dulus/main/docs/divider.svg" alt="" width="100%"></p>
+
+## Quick Start
+
+**Windows — no Python needed (1-click):**
+
+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:**
+
+```bash
+pip install dulus
+dulus
+```
+
+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.
+
+## Models
+
+Speak every dialect — switch mid-session with `/model`:
+
+| Kind | Providers |
+|---|---|
+| **Cloud** | Anthropic · OpenAI · Gemini · DeepSeek · Kimi · Qwen · Zhipu · MiniMax |
+| **Free tier** | **14 frontier models via NVIDIA NIM** — 40 RPM each, $0. Key at [build.nvidia.com](https://build.nvidia.com) |
+| **Gateway** | 100+ backends via LiteLLM — OpenRouter, Groq, Together, Bedrock, Vertex, xAI, Mistral... |
+| **Web chats** | Use the chats you **already pay for**: Claude.ai, Gemini, Kimi.com, Qwen, DeepSeek — parsed as providers |
+| **Local** | Ollama · LM Studio · any OpenAI-compatible endpoint. Runs offline, completely. |
+
+## Features
+
+The full tour lives on [the website](https://dulus.ai/) — highlights:
+
+- **27 built-in tools** — Read/Write/Edit, Bash, Glob/Grep, WebFetch/WebSearch, NotebookEdit, GetDiagnostics, Memory, Tasks, Agents, Skills...
+- **Sub-agents** — typed agents (coder, reviewer, researcher, tester), each in its own git worktree, talking via message passing
+- **Persistent memory + checkpoints** — never lose context. Ever. Open `~/.dulus/memory/` as an Obsidian vault
+- **Dulus OS** — not a CLI, a workstation for the agent (sandbox desktop in your browser)
+- **Voice** — offline Whisper STT, no API key, no cloud. Wake words included
+- **Brainstorm Mode** — multi-persona AI debate. Council of ghosts
+- **SSJ Developer Mode** — ten chained workflow shortcuts behind one keystroke: refactor → review → test → commit → ship
+- **Telegram bridge** — slash commands, vision, and voice from your phone
+- **Local OCR** — `/ocr`, `/img` with verbatim text extraction, zero vision tokens
+- **Plan mode, webchat UI, desktop GUI, task manager...** — [see the site](https://dulus.ai/)
+
+## Permissions
+
+Three modes, switchable any time with `/permissions [mode]`:
+
+| Mode | Behavior |
+|---|---|
+| `auto` (default) | Safe tools run free; risky actions (writes, shell) ask first |
+| `manual` | Everything asks |
+| `accept-all` | Never asks — YOLO. Also via `dulus --accept-all` |
+
+Answering `a` at any prompt upgrades the session to accept-all.
+
+## MCP
+
+Drop a `.mcp.json` in your project — every server registers instantly as `mcp__server__tool`. stdio, SSE, and HTTP transports.
+
+```
+/mcp                        # list servers and their tools
+/mcp add <name> <cmd>       # add a stdio server
+/mcp reload                 # reconnect all
+```
+
+## Plugins
+
+The **Auto-Adapter** onboards *any* Python repo as native tools — zero manifest, hot-reload, no restart:
+
+```
+/plugin install yfinance@https://github.com/ranaroussi/yfinance
+/plugin reload
+```
+
+Then just ask: *"dulus get the prices of NVDA, TSLA, SP500"*. Be creative — 800+ ready-made skills via Composio too.
+
+<p align="center"><img src="https://raw.githubusercontent.com/KevRojo/Dulus/main/docs/divider.svg" alt="" width="100%"></p>
+
+## 🔒 Privacy & anonymous telemetry (opt-in)
+
+On first launch Dulus asks **once** if you'd like to share anonymous usage
+statistics. **Nothing is sent unless you say yes.**
+
+| Collected (if you opt in) | NEVER collected |
+|---|---|
+| Event names (`session_start`, `tool_used`, `model_selected`) | Prompts or responses |
+| Dulus version, OS name, Python version | File contents or paths |
+| Provider/model names (e.g. `gemini`) | API keys or tokens |
+| A random anonymous ID generated on your machine | Emails, usernames, IPs (geo disabled) |
+
+Data goes to [Mixpanel](https://mixpanel.com) (event analytics). The full
+implementation is ~140 lines of readable code in [`analytics.py`](analytics.py) —
+audit it yourself.
+
+**Opt out anytime:**
+```
+/config telemetry=off        # inside Dulus
+DULUS_TELEMETRY=0            # environment variable
+```

dulus-3.5.0/analytics.py

@@ -0,0 +1,144 @@
+"""Dulus anonymous usage telemetry (opt-in, privacy-first).
+
+Dulus asks ONCE on startup whether you want to share anonymous usage
+statistics. Nothing is sent until you explicitly say yes.
+
+What IS collected (when enabled):
+  - Event names (session_start, message_sent, tool_used, model_selected)
+  - Dulus version, OS name, Python version
+  - Provider/model *names* (e.g. "gemini", "claude-sonnet")
+  - A random anonymous ID (UUID generated locally — not tied to you)
+
+What is NEVER collected:
+  - Prompts, responses, or any conversation content
+  - File paths, file contents, or code
+  - Usernames, emails, hostnames, IPs (Mixpanel geo is disabled via $ip=0)
+  - API keys or tokens
+
+Where it goes: Mixpanel (https://mixpanel.com) — event analytics only.
+
+Opt out at any time (any of these):
+  - Answer "n" at the first-run prompt
+  - /config telemetry=off        (inside Dulus)
+  - DULUS_TELEMETRY=0            (environment variable)
+
+Implementation notes: zero third-party dependencies — plain urllib POST to
+the Mixpanel ingestion API in a fire-and-forget daemon thread. Failures are
+silently ignored; telemetry must never slow down or break Dulus.
+"""
+from __future__ import annotations
+
+import base64
+import json
+import os
+import platform
+import sys
+import threading
+import time
+import uuid
+
+# Mixpanel PROJECT TOKEN for the public Dulus project.
+# 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_ENDPOINT = "https://api.mixpanel.com/track"
+
+# Populated by init_telemetry(); None = not initialised / disabled.
+_distinct_id: str | None = None
+_enabled: bool = False
+_dulus_version: str = ""
+
+
+def _env_disabled() -> bool:
+    return os.environ.get("DULUS_TELEMETRY", "").strip().lower() in ("0", "off", "false", "no")
+
+
+def is_enabled() -> bool:
+    return _enabled and not _env_disabled() and bool(MP_TOKEN)
+
+
+CONSENT_NOTICE = """
+  ── Ayuda a mejorar Dulus / Help improve Dulus ─────────────────────────
+  Dulus can share ANONYMOUS usage statistics to help us understand
+  which features matter (event counts only — sent to Mixpanel).
+
+    Collected:  event names, Dulus version, OS, model/provider names,
+                a random anonymous ID generated on this machine.
+    NEVER:      prompts, responses, files, paths, keys, emails, IPs.
+
+  Change your mind anytime:  /config telemetry=off   or  DULUS_TELEMETRY=0
+  ────────────────────────────────────────────────────────────────────────
+"""
+
+
+def ask_consent(config: dict) -> dict:
+    """One-time interactive consent prompt. Mutates + returns config.
+
+    Only call when config['telemetry'] is unset and stdin is a TTY.
+    """
+    print(CONSENT_NOTICE)
+    try:
+        answer = input("  Share anonymous usage stats? [y/N] ").strip().lower()
+    except (EOFError, KeyboardInterrupt):
+        answer = ""
+    config["telemetry"] = answer in ("y", "yes", "s", "si", "sí")
+    if config["telemetry"] and not config.get("telemetry_id"):
+        config["telemetry_id"] = uuid.uuid4().hex
+    state = "enabled — thank you! 🦅" if config["telemetry"] else "disabled."
+    print(f"  Telemetry {state}\n")
+    return config
+
+
+def init_telemetry(config: dict, version: str = "") -> None:
+    """Initialise the module from config. Safe to call multiple times."""
+    global _distinct_id, _enabled, _dulus_version
+    _dulus_version = version or _dulus_version
+    _enabled = bool(config.get("telemetry")) and not _env_disabled()
+    if _enabled:
+        _distinct_id = config.get("telemetry_id") or uuid.uuid4().hex
+        config.setdefault("telemetry_id", _distinct_id)
+
+
+def track(event: str, properties: dict | None = None) -> None:
+    """Fire-and-forget anonymous event. No-op unless telemetry is enabled."""
+    if not is_enabled() or not _distinct_id:
+        return
+
+    payload = {
+        "event": event,
+        "properties": {
+            "token": MP_TOKEN,
+            "distinct_id": _distinct_id,
+            "time": int(time.time()),
+            "$ip": 0,  # disable Mixpanel geolocation
+            "dulus_version": _dulus_version,
+            "os": platform.system(),
+            "python": f"{sys.version_info.major}.{sys.version_info.minor}",
+            **(properties or {}),
+        },
+    }
+
+    def _send() -> None:
+        try:
+            from urllib.request import Request, urlopen
+            from urllib.parse import urlencode
+
+            data = urlencode(
+                {"data": base64.b64encode(json.dumps([payload]).encode()).decode()}
+            ).encode()
+            req = Request(_MP_ENDPOINT, data=data, method="POST")
+            urlopen(req, timeout=4).read()
+        except Exception:
+            pass  # telemetry must never break Dulus
+
+    threading.Thread(target=_send, daemon=True, name="telemetry").start()
+
+
+def track_session_start(config: dict) -> None:
+    """Convenience: one event per REPL boot (enough for DAU/MAU counts)."""
+    track("session_start", {
+        "provider": str(config.get("provider", "")),
+        "model": str(config.get("model", "")),
+    })