dulus 3.13.1__tar.gz → 3.13.2__tar.gz

{dulus-3.13.1/dulus.egg-info → dulus-3.13.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: dulus
-Version: 3.13.1
+Version: 3.13.2
 Summary: Provider-independent agent runtime for the terminal — cloud and local models, real tools, MCP, plugins, memory, sub-agents, and Dulus OS.
 Author-email: KevRojo <dev@dulus.ai>
 Maintainer-email: KevRojo <dev@dulus.ai>
@@ -56,6 +56,7 @@ Requires-Dist: typing-extensions>=4.10.0
 Requires-Dist: pyttsx3
 Requires-Dist: composio>=1.0.0rc2
 Requires-Dist: beautifulsoup4>=4.12.0
+Requires-Dist: segno>=1.6.0
 Requires-Dist: sentry-sdk>=2.0.0
 Requires-Dist: truststore>=0.9
 Requires-Dist: pytesseract>=0.3.10
@@ -129,7 +130,63 @@ Requires-Dist: pytesseract>=0.3.10; extra == "full"
 </p>
 
 <p align="center">
-  <a href="https://dulus.online"><strong>🚀 Start on the router → dulus.online</strong></a>
+  <strong>🔑 Need an API key?</strong> Stop waiting on the website.<br>
+  It has been in <strong>dulus-public (pip)</strong> forever — mint it from the CLI:
+</p>
+
+```bash
+pip install -U dulus
+dulus
+# inside the REPL:
+/login dulus        # sign in (OAuth — browser opens)
+/login dulus key    # mint a dulus_sk_* key (shown once)
+```
+
+```bash
+# then point anything OpenAI-compatible at the router
+export OPENAI_API_KEY='dulus_sk_...'          # the key you just minted
+export OPENAI_BASE_URL='https://control.dulus.ai/v1'
+# or:  openai.base_url = "https://control.dulus.ai/v1"
+```
+
+<p align="center">
+  <em>Damn brother… are you really waiting for the website update to get your API key?</em><br>
+  That’s on Dulus-public since years. Have fun. It was a surprise u,u — <strong>$DULUS</strong>
+</p>
+
+<p align="center">
+  <a href="#get-your-dulus-api-key-no-website-required"><strong>🔑 Get your API key from pip →</strong></a>
+  ·
+  <a href="https://dulus.online"><strong>🚀 Platform → dulus.online</strong></a>
+</p>
+
+
+<p align="center">
+  <strong>⛽ $DULUS Fuel is LIVE in the CLI — <code>/fuel</code> is ready.</strong><br>
+  Sign in, get your <strong>reload wallet as a console QR</strong>, scan with Phantom / Solflare,<br>
+  send <strong>$DULUS</strong>, and Fuel credits hit your account. Utility coin that actually powers AI.
+</p>
+
+```bash
+pip install -U dulus
+dulus
+# inside the REPL:
+/login dulus     # sign in
+/fuel            # balance + scannable reload-wallet QR
+/fuel deposit    # QR only
+```
+
+<p align="center">
+  <em>Tested. Reloaded. Fuel credited.</em> We’re not playing points — this is on-chain gas for inference.<br>
+  <strong>$DULUS</strong> · <code>control.dulus.ai/v1</code> · 12+ models · spent by the token 🦅
+</p>
+
+<p align="center">
+  <a href="#fuel--reload-wallet-qr-ready"><strong>⛽ /fuel walkthrough →</strong></a>
+  ·
+  <a href="#get-your-dulus-api-key-no-website-required"><strong>🔑 API key from pip →</strong></a>
+  ·
+  <a href="https://dulus.online"><strong>🚀 dulus.online</strong></a>
 </p>
 
 <p align="center">
@@ -147,12 +204,10 @@ Requires-Dist: pytesseract>=0.3.10; extra == "full"
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-GPLv3-ff6b1f?style=flat-square&labelColor=07070a" alt="GPLv3 license"></a>
 </p>
 
-<p align="center">
-  <a href="docs/Dulus_YC_Company_Overview_Aug_2026.pdf"><strong>📈 Investors — read the company overview (PDF) ↗</strong></a>
-</p>
-
 <p align="center">
   <a href="#install-in-30-seconds"><strong>Install</strong></a> ·
+  <a href="#get-your-dulus-api-key-no-website-required"><strong>API key</strong></a> ·
+  <a href="#fuel--reload-wallet-qr-ready"><strong>Fuel / QR</strong></a> ·
   <a href="#why-dulus"><strong>Why Dulus</strong></a> ·
   <a href="#one-runtime-every-model"><strong>Models</strong></a> ·
   <a href="#turn-any-python-repo-into-tools"><strong>Extensions</strong></a> ·
@@ -194,6 +249,98 @@ Rather use keys, local models, or your own endpoint? Dulus does that too — **3
 
 ---
 
+---
+
+## Fuel + reload wallet QR (READY)
+
+**`/fuel` is ready.** Top up AI compute with **$DULUS** — the utility token that *is* your credit.
+
+```text
+/login dulus      # OAuth — browser opens
+/fuel             # ⛽ balance + console QR of YOUR reload wallet
+/fuel deposit     # address + QR only
+/fuel balance     # balance only
+```
+
+1. Run `/fuel` — Dulus prints your unique Solana deposit address **and a terminal QR** (segno, scannable).
+2. Open **Phantom / Solflare** → scan the QR → send **$DULUS**.
+3. Control plane credits **Fuel** to your account.
+4. Burn it on `dulus-*` models via the CLI or `https://control.dulus.ai/v1`.
+
+No website form. No waiting on a dashboard refresh to *see* the wallet. The QR is in your terminal the second you login.
+
+```bash
+pip install -U dulus   # includes segno for console QR
+dulus
+```
+
+| Command | What you get |
+|---|---|
+| `/login dulus` | Sign in + reload QR on success |
+| `/fuel` | Balance + reload wallet QR |
+| `/fuel deposit` | QR / address only |
+| `/login dulus key` | Mint `dulus_sk_*` for OpenAI SDK → same Fuel pool |
+
+**$DULUS** = on-chain gas for inference. Transferable. Spent by the token. Tested end-to-end — reload lands, Fuel credits. 🦅
+
+---
+
+## Get your Dulus API key (no website required)
+
+Damn brother… are you really waiting for the website update to get your API key?
+
+**You don’t need the website.** Minting a `dulus_sk_*` key has been in **dulus-public** (`pip install dulus`) for ages. The CLI talks straight to the control plane.
+
+```bash
+pip install -U dulus
+dulus
+```
+
+Inside the REPL:
+
+```text
+/login dulus        # sign in (OAuth PKCE — browser opens, no API key pasted by hand)
+/login dulus key    # mint a dulus_sk_* key for CI, SDKs, servers (shown once — copy it)
+```
+
+Then point **any** OpenAI-compatible client at the router and burn **$DULUS** fuel by the token:
+
+```bash
+export OPENAI_API_KEY='dulus_sk_...' 
+export OPENAI_BASE_URL='https://control.dulus.ai/v1'
+```
+
+```python
+from openai import OpenAI
+client = OpenAI(
+    api_key="dulus_sk_...",                 # from /login dulus key
+    base_url="https://control.dulus.ai/v1",
+)
+r = client.chat.completions.create(
+    model="dulus-a-9b",  # or dulus-b-27b, dulus-x-397b, …
+    messages=[{"role": "user", "content": "hola desde el router"}],
+)
+print(r.choices[0].message.content)
+```
+
+Or stay inside Dulus and use the built-in provider (same login, Fuel-metered):
+
+```text
+/login dulus
+/model dulus-a-9b
+```
+
+| Want | Do this |
+|---|---|
+| Interactive agent on Dulus models | `/login dulus` then `/model dulus-*` |
+| API key for scripts / CI / other tools | `/login dulus key` → `dulus_sk_*` |
+| OpenAI SDK / anything compatible | `base_url=https://control.dulus.ai/v1` + that key |
+| Fuel (`$DULUS`) | Spent per token on the control plane — utility coin, not a wallpaper ticker |
+
+It was a surprise u,u — have fun. 🦅 **$DULUS**
+
+---
+
 ## New — Python console: a live heap that costs no tokens
 
 > 🧪 Fresh out of the private build. Try it and tell me how it feels.
@@ -347,7 +494,13 @@ dulus
 ### Pick any brain
 
 ```bash
-# Cloud provider
+# Dulus router (Fuel / $DULUS) — no website key form
+dulus
+# /login dulus
+# /login dulus key          # mint dulus_sk_* for SDKs
+# /model dulus-a-9b
+
+# Cloud provider key
 export ANTHROPIC_API_KEY=sk-ant-...
 dulus --model claude-sonnet-4-6
 
@@ -359,7 +512,7 @@ dulus --model ollama/qwen2.5-coder
 git diff | dulus -p "review this diff and find the dangerous parts"
 ```
 
-No key yet? Start with Ollama, use NVIDIA NIM's free tier, or configure one of the supported browser-backed providers from the welcome flow.
+No third-party key yet? Use **`/login dulus`** for the hosted router, start with Ollama, NVIDIA NIM's free tier, or a browser-backed provider from the welcome flow.
 
 ---
 
@@ -403,10 +556,15 @@ Dulus does not make model choice an architectural decision. Switch providers dur
 | **Local** | Ollama · LM Studio · vLLM · any OpenAI-compatible endpoint |
 | **Edge / on-device** | `edge/*` — small models on your phone or in Termux via llama.cpp / Ollama |
 | **Browser-backed** | Supported authenticated sessions for Claude, Gemini, Kimi, Qwen, and DeepSeek |
+| **Dulus router (`$DULUS` Fuel)** | `dulus-*` models on `https://control.dulus.ai/v1` — `/login dulus` or `dulus_sk_*` from `/login dulus key` |
 | **Free tier** | 14 models through NVIDIA NIM with automatic fallback |
 
 ```text
 /model
+/login dulus
+/model dulus-a-9b
+/model dulus-b-27b
+/model dulus-x-397b
 /model claude-sonnet-4-6
 /model nvidia-web/deepseek-r1
 /model ollama/qwen2.5-coder
@@ -644,7 +802,8 @@ Type `/` and press Tab inside the REPL to explore the live command list.
 
 | Area | Commands |
 |---|---|
-| Models | `/model` · `/nvidia` · `/ollama` |
+| Account / Fuel | `/login dulus` · `/login dulus key` (mint `dulus_sk_*`) |
+| Models | `/model` · `/nvidia` · `/ollama` · `dulus-*` on the router |
 | Sessions | `/save` · `/load` · `/resume` · `/compact` |
 | Memory | `/remember` · `/memory` |
 | Work | `/task` · `/agents` · `/worker` · `/checkpoint` |
@@ -773,8 +932,6 @@ Documentation:
 - [Contributing](docs/CONTRIBUTING.md)
 - [Security](docs/SECURITY.md)
 - [Release notes](docs/news.md)
-- [Whitepaper](docs/Dulus_AI_Whitepaper_%28v2.0%29.pdf)
-
 ---
 
 ## Shipping in public

{dulus-3.13.1 → dulus-3.13.2}/README.md

@@ -32,7 +32,63 @@
 </p>
 
 <p align="center">
-  <a href="https://dulus.online"><strong>🚀 Start on the router → dulus.online</strong></a>
+  <strong>🔑 Need an API key?</strong> Stop waiting on the website.<br>
+  It has been in <strong>dulus-public (pip)</strong> forever — mint it from the CLI:
+</p>
+
+```bash
+pip install -U dulus
+dulus
+# inside the REPL:
+/login dulus        # sign in (OAuth — browser opens)
+/login dulus key    # mint a dulus_sk_* key (shown once)
+```
+
+```bash
+# then point anything OpenAI-compatible at the router
+export OPENAI_API_KEY='dulus_sk_...'          # the key you just minted
+export OPENAI_BASE_URL='https://control.dulus.ai/v1'
+# or:  openai.base_url = "https://control.dulus.ai/v1"
+```
+
+<p align="center">
+  <em>Damn brother… are you really waiting for the website update to get your API key?</em><br>
+  That’s on Dulus-public since years. Have fun. It was a surprise u,u — <strong>$DULUS</strong>
+</p>
+
+<p align="center">
+  <a href="#get-your-dulus-api-key-no-website-required"><strong>🔑 Get your API key from pip →</strong></a>
+  ·
+  <a href="https://dulus.online"><strong>🚀 Platform → dulus.online</strong></a>
+</p>
+
+
+<p align="center">
+  <strong>⛽ $DULUS Fuel is LIVE in the CLI — <code>/fuel</code> is ready.</strong><br>
+  Sign in, get your <strong>reload wallet as a console QR</strong>, scan with Phantom / Solflare,<br>
+  send <strong>$DULUS</strong>, and Fuel credits hit your account. Utility coin that actually powers AI.
+</p>
+
+```bash
+pip install -U dulus
+dulus
+# inside the REPL:
+/login dulus     # sign in
+/fuel            # balance + scannable reload-wallet QR
+/fuel deposit    # QR only
+```
+
+<p align="center">
+  <em>Tested. Reloaded. Fuel credited.</em> We’re not playing points — this is on-chain gas for inference.<br>
+  <strong>$DULUS</strong> · <code>control.dulus.ai/v1</code> · 12+ models · spent by the token 🦅
+</p>
+
+<p align="center">
+  <a href="#fuel--reload-wallet-qr-ready"><strong>⛽ /fuel walkthrough →</strong></a>
+  ·
+  <a href="#get-your-dulus-api-key-no-website-required"><strong>🔑 API key from pip →</strong></a>
+  ·
+  <a href="https://dulus.online"><strong>🚀 dulus.online</strong></a>
 </p>
 
 <p align="center">
@@ -50,12 +106,10 @@
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-GPLv3-ff6b1f?style=flat-square&labelColor=07070a" alt="GPLv3 license"></a>
 </p>
 
-<p align="center">
-  <a href="docs/Dulus_YC_Company_Overview_Aug_2026.pdf"><strong>📈 Investors — read the company overview (PDF) ↗</strong></a>
-</p>
-
 <p align="center">
   <a href="#install-in-30-seconds"><strong>Install</strong></a> ·
+  <a href="#get-your-dulus-api-key-no-website-required"><strong>API key</strong></a> ·
+  <a href="#fuel--reload-wallet-qr-ready"><strong>Fuel / QR</strong></a> ·
   <a href="#why-dulus"><strong>Why Dulus</strong></a> ·
   <a href="#one-runtime-every-model"><strong>Models</strong></a> ·
   <a href="#turn-any-python-repo-into-tools"><strong>Extensions</strong></a> ·
@@ -97,6 +151,98 @@ Rather use keys, local models, or your own endpoint? Dulus does that too — **3
 
 ---
 
+---
+
+## Fuel + reload wallet QR (READY)
+
+**`/fuel` is ready.** Top up AI compute with **$DULUS** — the utility token that *is* your credit.
+
+```text
+/login dulus      # OAuth — browser opens
+/fuel             # ⛽ balance + console QR of YOUR reload wallet
+/fuel deposit     # address + QR only
+/fuel balance     # balance only
+```
+
+1. Run `/fuel` — Dulus prints your unique Solana deposit address **and a terminal QR** (segno, scannable).
+2. Open **Phantom / Solflare** → scan the QR → send **$DULUS**.
+3. Control plane credits **Fuel** to your account.
+4. Burn it on `dulus-*` models via the CLI or `https://control.dulus.ai/v1`.
+
+No website form. No waiting on a dashboard refresh to *see* the wallet. The QR is in your terminal the second you login.
+
+```bash
+pip install -U dulus   # includes segno for console QR
+dulus
+```
+
+| Command | What you get |
+|---|---|
+| `/login dulus` | Sign in + reload QR on success |
+| `/fuel` | Balance + reload wallet QR |
+| `/fuel deposit` | QR / address only |
+| `/login dulus key` | Mint `dulus_sk_*` for OpenAI SDK → same Fuel pool |
+
+**$DULUS** = on-chain gas for inference. Transferable. Spent by the token. Tested end-to-end — reload lands, Fuel credits. 🦅
+
+---
+
+## Get your Dulus API key (no website required)
+
+Damn brother… are you really waiting for the website update to get your API key?
+
+**You don’t need the website.** Minting a `dulus_sk_*` key has been in **dulus-public** (`pip install dulus`) for ages. The CLI talks straight to the control plane.
+
+```bash
+pip install -U dulus
+dulus
+```
+
+Inside the REPL:
+
+```text
+/login dulus        # sign in (OAuth PKCE — browser opens, no API key pasted by hand)
+/login dulus key    # mint a dulus_sk_* key for CI, SDKs, servers (shown once — copy it)
+```
+
+Then point **any** OpenAI-compatible client at the router and burn **$DULUS** fuel by the token:
+
+```bash
+export OPENAI_API_KEY='dulus_sk_...' 
+export OPENAI_BASE_URL='https://control.dulus.ai/v1'
+```
+
+```python
+from openai import OpenAI
+client = OpenAI(
+    api_key="dulus_sk_...",                 # from /login dulus key
+    base_url="https://control.dulus.ai/v1",
+)
+r = client.chat.completions.create(
+    model="dulus-a-9b",  # or dulus-b-27b, dulus-x-397b, …
+    messages=[{"role": "user", "content": "hola desde el router"}],
+)
+print(r.choices[0].message.content)
+```
+
+Or stay inside Dulus and use the built-in provider (same login, Fuel-metered):
+
+```text
+/login dulus
+/model dulus-a-9b
+```
+
+| Want | Do this |
+|---|---|
+| Interactive agent on Dulus models | `/login dulus` then `/model dulus-*` |
+| API key for scripts / CI / other tools | `/login dulus key` → `dulus_sk_*` |
+| OpenAI SDK / anything compatible | `base_url=https://control.dulus.ai/v1` + that key |
+| Fuel (`$DULUS`) | Spent per token on the control plane — utility coin, not a wallpaper ticker |
+
+It was a surprise u,u — have fun. 🦅 **$DULUS**
+
+---
+
 ## New — Python console: a live heap that costs no tokens
 
 > 🧪 Fresh out of the private build. Try it and tell me how it feels.
@@ -250,7 +396,13 @@ dulus
 ### Pick any brain
 
 ```bash
-# Cloud provider
+# Dulus router (Fuel / $DULUS) — no website key form
+dulus
+# /login dulus
+# /login dulus key          # mint dulus_sk_* for SDKs
+# /model dulus-a-9b
+
+# Cloud provider key
 export ANTHROPIC_API_KEY=sk-ant-...
 dulus --model claude-sonnet-4-6
 
@@ -262,7 +414,7 @@ dulus --model ollama/qwen2.5-coder
 git diff | dulus -p "review this diff and find the dangerous parts"
 ```
 
-No key yet? Start with Ollama, use NVIDIA NIM's free tier, or configure one of the supported browser-backed providers from the welcome flow.
+No third-party key yet? Use **`/login dulus`** for the hosted router, start with Ollama, NVIDIA NIM's free tier, or a browser-backed provider from the welcome flow.
 
 ---
 
@@ -306,10 +458,15 @@ Dulus does not make model choice an architectural decision. Switch providers dur
 | **Local** | Ollama · LM Studio · vLLM · any OpenAI-compatible endpoint |
 | **Edge / on-device** | `edge/*` — small models on your phone or in Termux via llama.cpp / Ollama |
 | **Browser-backed** | Supported authenticated sessions for Claude, Gemini, Kimi, Qwen, and DeepSeek |
+| **Dulus router (`$DULUS` Fuel)** | `dulus-*` models on `https://control.dulus.ai/v1` — `/login dulus` or `dulus_sk_*` from `/login dulus key` |
 | **Free tier** | 14 models through NVIDIA NIM with automatic fallback |
 
 ```text
 /model
+/login dulus
+/model dulus-a-9b
+/model dulus-b-27b
+/model dulus-x-397b
 /model claude-sonnet-4-6
 /model nvidia-web/deepseek-r1
 /model ollama/qwen2.5-coder
@@ -547,7 +704,8 @@ Type `/` and press Tab inside the REPL to explore the live command list.
 
 | Area | Commands |
 |---|---|
-| Models | `/model` · `/nvidia` · `/ollama` |
+| Account / Fuel | `/login dulus` · `/login dulus key` (mint `dulus_sk_*`) |
+| Models | `/model` · `/nvidia` · `/ollama` · `dulus-*` on the router |
 | Sessions | `/save` · `/load` · `/resume` · `/compact` |
 | Memory | `/remember` · `/memory` |
 | Work | `/task` · `/agents` · `/worker` · `/checkpoint` |
@@ -676,8 +834,6 @@ Documentation:
 - [Contributing](docs/CONTRIBUTING.md)
 - [Security](docs/SECURITY.md)
 - [Release notes](docs/news.md)
-- [Whitepaper](docs/Dulus_AI_Whitepaper_%28v2.0%29.pdf)
-
 ---
 
 ## Shipping in public

{dulus-3.13.1 → dulus-3.13.2}/docs/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.13.2] - 2026-08-31
+
+### Added
+- **`/fuel`** — $DULUS Fuel balance + console-scannable reload wallet QR (`segno`)
+- Post-`/login dulus` shows the deposit QR so you can top up from Phantom/Solflare immediately
+- Aliases: `/reload`, `/deposit`; subcommands `deposit` / `balance`
+- Dependency: `segno>=1.6.0` for terminal QR
+
+### Verified
+- End-to-end reload: send $DULUS → Fuel credited on control plane
+
+
 ## [3.13.1] - 2026-08-31
 
 ### Fixed

{dulus-3.13.1 → dulus-3.13.2}/docs/README.md

@@ -17,7 +17,6 @@ installation paths, screenshots, and feature tour, start with the
 | Review the security and permission model | [Security](SECURITY.md) |
 | Diagnose a common problem | [FAQ](FAQ.md) |
 | See what shipped | [Release journal](news.md) and [changelog](CHANGELOG.md) |
-| Read the longer product thesis | [Dulus AI whitepaper](Dulus_AI_Whitepaper_%28v2.0%29.pdf) |
 
 ## Runtime map
 

{dulus-3.13.1 → dulus-3.13.2}/docs/news.md

@@ -2,6 +2,9 @@
  
 ## 🔥🔥🔥 News (Pacific Time)
 
+- August 31, 2026 (**v3.13.2**): **⛽ `/fuel` is READY — reload wallet as a console QR.** Sign in with `/login dulus`, run `/fuel`, scan the QR with Phantom/Solflare, send **$DULUS**, and Fuel credits hit your account. Real utility coin for real AI compute — not points, not a waitlist. `pip install -U dulus`. 🦅🇩🇴
+
+
 - August 31, 2026 (**v3.13.1**): **📂 `/load` shows your real saves again.** The menu was only listing system auto-saves under `sessions/daily/`, so the sessions you kept with `/save` never appeared. Default `/load` (and the GUI session list) now reads the root of `sessions/` — your explicit saves. Auto-saves stay opt-in with `/load daily`. `pip install --upgrade dulus`. 🦅🇩🇴