▲ DULUS

Use IA agents without an API key. $0.

Hunt. Patch. Ship. A Python autonomous agent that flies on any model — and uniquely opens your browser, captures your Gemini (guest, no login) · Claude.ai · Claude Code · Kimi.com · Qwen · DeepSeek session, then lets you drive frontier IA as if it were an API. No api key. No subscription. No credit card.

Plus 100+ paid providers via LiteLLM (OpenRouter, Groq, Together, xAI, Mistral, Bedrock, …), local models via Ollama, /lang in 34 languages, Mesa Redonda multi-model debate, voice in/out, local OCR, MemPalace semantic memory, embedded sandbox OS. ~12K lines of readable Python. No build step. No gatekeeping. Just talons.

pip install dulus → press Enter → working IA in 30 seconds. Try it.

SET /sticky_input ON since the first run for the best experience!

The Dulus (Cigua Palmera) — Dominican national bird. Named after the bird, not the rocket.

Quick Start · Models · Features · Permissions · MCP · Plugins

Official X / creator handle: @KevRojox — that's me, the only contributor to this repo. Any other account claiming to be Dulus is a copycat.

$DULUS AI token Solana): 9R8rrjXxcfQPmLTCLhmVpjr2uesjjkcgkinE6Lwdpump

$DULUS AI GemPump Solana): 9R8rrjXxcfQPmLTCLhmVpjr2uesjjkcgkinE6Lwdpump

I created this token. I won't sell. I will keep building. This open-source project stays free forever — business version incoming. 🦅🇩🇴

Why a Solana Token?

Someone from the community launched a $DULUS token before I did. Good intentions — but confidence was shaky and the early believers were at risk of being taken advantage of by people who didn't actually care about the project.

I didn't want that. The people who bet on Dulus early deserved a token backed by the actual builder. So I launched the official one myself — full transparency, public GitHub, my name on it. No anonymous dev. 30M tokens locked. Just the project and its creator.

I'm top holder. I bought my position with my own funds. I'm not selling.

$DULUS — Token Utility Roadmap

The token isn't decoration. It's the fuel layer for everything Dulus is building.

Phase	Utility
Now	Community ownership. Creator-fee rewards locked on-chain to the builder. Alignment over extraction.
Business v1	$DULUS holders get early access + discounted seats on the Dulus Business tier (multi-user workspaces, cloud-hosted instances, shared MemPalace).
Credits	Pay for Dulus Business API credits with $DULUS — provider costs, inference minutes, premium model usage.
Deployments	Spin up a cloud Dulus instance and pay the hosting with $DULUS. No fiat friction, no middleman.
Subscriptions	Monthly Dulus Pro subscription payable in $DULUS. Hold enough → fee discount tier.
Governance	Top holders vote on feature priority and plugin marketplace policies. The flock decides.

The open-source REPL stays free forever. $DULUS is the key to the business layer — not a gate on what already exists.

---

A message to the community —

I want to talk about the token. Honestly. No hype.

I didn't launch it to get rich. The community launched it first, and when I saw early believers exposed without the actual builder behind it, I stepped in. I bought my position using the contract's own creator rewards. Zero personal capital deployed. I haven't sold a single token.

But there's something bigger I want you to understand:

$DULUS has a real purpose.

The open-source project isn't going anywhere. The REPL, the tools, the free model tier — that stays free forever. But Dulus is growing into a business layer: cloud-hosted instances, multi-user workspaces, model credits, managed deployments.

And that business layer is going to run on $DULUS.

The token will be how you pay for Pro subscriptions. How you buy inference credits. How you spin up a cloud instance without fiat friction. Holders with enough weight get automatic tier discounts. And eventually — the flock votes: top holders decide feature priority and plugin marketplace policies.

This isn't a promise. It's the architecture. That's how I've designed it.

So when someone asks "what's the token for" — the answer is: it's the fuel for Dulus's business layer. The more I build, the more it makes sense to hold.

We keep flying. 🦅🇩🇴

— KevRojo / @KevRojox

---

$Dulus Ai CA > 9R8rrjXxcfQPmLTCLhmVpjr2uesjjkcgkinE6Lwdpump

---

pip install dulus

🌐 Visit the Dulus website →
_{The site covers features, demos, and details not documented in this README.}

🔥 What's new

Full changelog: docs/news.md · Inside the REPL: /news

• 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.

What is this

Talent cant be copied.

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

_{⚡ Saves you Claude tokens? Throw a sat — BTC: 1JzatQDn9fMLnKTd3KYgztsLHC95bJEzSN}

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

Dulus is a lightweight Python reimplementation of Claude Code that isn't locked to Claude. It ships the whole loop — REPL, tool dispatch, streaming, context compaction, checkpoints, sub-agents, voice, Telegram bridge, MCP, plugins — in roughly 12K lines you can actually read. Fork it. Bend it. Run it offline against Qwen on your M2.

v0.2.60 — May 13, 2026 — WebBridge: browser automation with Playwright. Navigate, click, type, evaluate JS, take screenshots — all from the CLI. pip install dulus[webbridge] to enable. Type /news to see the full changelog.

---

Quick Start

Option A — One-liner installer (recommended)

Linux / macOS / WSL / Termux:

curl -fsSL https://raw.githubusercontent.com/KevRojo/Dulus/main/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/KevRojo/Dulus/main/install.ps1 | iex

The installer detects your OS, package manager, Python version, and WSLg audio bridge, then asks which profile you want:

• full — everything: voice (Whisper + PortAudio), browser tools (Playwright), MemPalace semantic memory, tmux, WSL audio bridge (~1.5 GB).
• standard — REPL + webchat + tmux daemon + Telegram bridge (~300 MB).
• basic — bare pip install dulus for servers / minimal sandboxes (~150 MB).
• custom — toggle each feature one by one.

It installs only what's missing and never silently runs sudo — you choose between auto-install, "show me the command", or skip.

Power-user flags:

# Preview without changing anything
curl -fsSL .../install.sh | bash -s -- --dry-run

# Non-interactive install (CI / scripts)
curl -fsSL .../install.sh | bash -s -- --profile=full --pipx

# Latest pre-release
curl -fsSL .../install.sh | bash -s -- --pre

# PowerShell equivalents
irm .../install.ps1 | iex
$env:DULUS_PROFILE='standard'; irm .../install.ps1 | iex   # preset via env
.\install.ps1 -DryRun -Profile full                        # local run

Option B — Docker (zero local Python setup)

# 1. Grab the compose file + env template
curl -fsSLO https://raw.githubusercontent.com/KevRojo/Dulus/main/docker-compose.yml
curl -fsSLO https://raw.githubusercontent.com/KevRojo/Dulus/main/.env.example
mv .env.example .env   # then add your API keys

# 2. Pull and run (WebChat at http://localhost:5050 — shifted off 5000
#    so it doesn't collide with a native Dulus install on the same host)
docker compose up -d

# 3. Or jump into the REPL inside the container
docker compose exec dulus dulus

Image: ghcr.io/kevrojo/dulus · Memory persists in the dulus-memory volume.

Option C — Manual pip / source

---

---

---

ROUND TABLE (DULUS UNIQUE FEATURE)

Dulus is the first one meeting multiple models at the same time working for the same objective and sharing their ideas.

One-liner

pip install dulus && dulus              # core CLI — fast, no compile, works on termux
pip install "dulus[memory]" && dulus    # +MemPalace per-turn memory (pulls chromadb)

That's it. Dulus prompts you for a key on first run. The [memory] extra pulls in mempalace and its chromadb chain — skip it on Android/termux or anywhere wheels for numpy/onnxruntime aren't available; the CLI still boots and chats fine without it.

Thanks for all the love on PyPi, the launch on PyPi was on 05-05-2026

---

From source (hacking on Dulus itself)

git clone https://github.com/KevRojo/Dulus && cd Dulus
pip install -e .          # editable install
dulus

Termux / Android

The default install pulls mempalace and sounddevice, both of which need a NumPy that has no prebuilt wheel for aarch64-android — pip will try to build NumPy from source and fail. Install around it:

pkg install python python-numpy python-pillow build-essential
pip install --no-deps dulus
pip install anthropic openai httpx requests rich prompt_toolkit Flask bubblewrap-cli mempalace

Skip sounddevice (no usable PortAudio on Android — voice features won't work anyway). Dulus's runtime is graceful: voice / MemPalace just degrade if their deps aren't there, the CLI still boots and chats fine.

Pick a model

export ANTHROPIC_API_KEY=sk-ant-...     # or OPENAI_API_KEY, GEMINI_API_KEY, ...
dulus

Zero API keys? Two free paths:

# 1. NVIDIA NIM — 14 models free, 40 RPM each, no card
dulus --model nvidia-web/deepseek-ai/deepseek-r1

# 2. Fully offline via Ollama
ollama pull qwen2.5-coder
dulus --model ollama/qwen2.5-coder

Or pipe it like a good unix citizen:

echo "explain this diff" | git diff | dulus -p --accept-all

---

_{↑ session boot. soul loaded, gold memory warm, shell sniffed. the little circles are real buttons on your Mac.}

💻 Dulus OS (Sandbox)

Note

Experimental features: The folder sandbox/ contains the early implementation of Dulus OS — a mini-operating system that runs entirely in your browser. It is currently in heavy development and not 100% functional yet. It will serve as a secure, isolated environment for browser-based tool execution and visualizations.

---

---

---

The dulus sandbox is an early feature, expect bugs

---

Features

Multi-provider	Anthropic · OpenAI · Gemini · Kimi · Qwen · Zhipu · DeepSeek · MiniMax · Ollama · LM Studio · custom OpenAI-compat endpoints
27 built-in tools	Read, Write, Edit, Bash, Glob, Grep, WebFetch, WebSearch, NotebookEdit, GetDiagnostics, Memory, Tasks, Agents, Skills, and more
MCP integration	Any MCP server (stdio / SSE / HTTP). Tools auto-registered as mcp__<server>__<tool>
Plugin system	Auto-Adapter onboards any Python repo — zero manifest required. Hot-reload in-session.
Sub-agents	Typed agents (coder / reviewer / researcher / tester) in isolated git worktrees
Voice input	Offline STT via Whisper. No API key. No cloud.
Brainstorm	Multi-persona AI debate. Auto-generated expert roles.
SSJ Developer Mode	Power menu: 10 workflow shortcuts behind one keystroke
Telegram bridge	Run Dulus from your phone. Slash commands. Vision. Voice. Multi-user authorized list.
Checkpoints	Auto-snapshot conversation + files. Rewind to any turn.
Plan mode	Read-only analysis phase before touching anything
Context compression	Auto-compact long sessions. Keep the signal, drop the slop.
tmux tools	11 tools for the agent to drive tmux sessions
Persistent memory	Dual-scope (user + project). Ranked by confidence × recency.
Session management	Autosave · daily archives · cloud sync via GitHub Gist

---

Models

Cloud APIs

Provider	Models	Env
Anthropic	claude-opus-4-6, claude-sonnet-4-6, claude-haiku-4-5-20251001	ANTHROPIC_API_KEY
OpenAI	gpt-4o, gpt-4o-mini, o3-mini, o1	OPENAI_API_KEY
Google	gemini-2.5-pro-preview-03-25, gemini-2.0-flash, gemini-1.5-pro	GEMINI_API_KEY
DeepSeek	deepseek-chat, deepseek-reasoner	DEEPSEEK_API_KEY
Qwen	qwen-max, qwen-plus, qwen-turbo, qwq-32b	DASHSCOPE_API_KEY
Kimi	moonshot-v1-8k/32k/128k, kimi-k2.5	MOONSHOT_API_KEY
Zhipu	glm-4-plus, glm-4, glm-4-flash	ZHIPU_API_KEY
MiniMax	MiniMax-Text-01, MiniMax-VL-01, abab6.5s-chat	MINIMAX_API_KEY

Local

# Ollama (recommended: qwen2.5-coder, llama3.3, mistral, phi4)
dulus --model ollama/qwen2.5-coder

# LM Studio
dulus --model lmstudio/<model>

# Any OpenAI-compat server
export CUSTOM_BASE_URL=http://localhost:8000/v1
dulus --model custom/<model>

Switching models mid-flight

/model                         # show current
/model gpt-4o                  # switch
/model kimi:moonshot-v1-32k    # colon syntax works too

---

Free Tier Providers

No credit card. No waiting list. No "contact sales". Just frontier models, on tap.

Dulus ships a nvidia-web provider that talks to NVIDIA NIM — NVIDIA's hosted inference API. Sign up, grab a key, and you've got 14 top-tier models running at 40 requests per minute each, for free. When one model hits its ceiling, Dulus auto-falls to the next one in the chain. Zero downtime. Zero config.

export NVIDIA_API_KEY=nvapi-...
dulus --model nvidia-web/deepseek-r1

Model	Type	ID
DeepSeek V4 Flash	Instruct	nvidia-web/deepseek-ai/deepseek-v4-flash
GLM-4.7	Zhipu AI	nvidia-web/z-ai/glm-4.7
GLM-5.1	Zhipu AI	nvidia-web/z-ai/glm-5.1
MiniMax M2.7	Text + Vision	nvidia-web/minimaxai/minimax-m2.7
Kimi K2 Instruct	Long context	nvidia-web/moonshotai/kimi-k2-instruct
Mistral Nemotron	NVIDIA-tuned	nvidia-web/mistralai/mistral-nemotron
Seed OSS 36B	ByteDance	nvidia-web/bytedance/seed-oss-36b-instruct
Solar 10.7B	Upstage	nvidia-web/upstage/solar-10.7b-instruct
Step 3.5 Flash	StepFun	nvidia-web/stepfun-ai/step-3.5-flash
Llama 3.3 70B	Meta	nvidia-web/meta/llama-3.3-70b-instruct
Kimi K2.5	Long context	nvidia-web/moonshotai/kimi-k2.5
DeepSeek R1	Reasoning	nvidia-web/deepseek-ai/deepseek-r1
Llama Nemotron 70B	NVIDIA reasoning	nvidia-web/nvidia/llama-3.1-nemotron-70b-instruct
Qwen2.5 72B	Alibaba	nvidia-web/qwen/qwen2.5-72b-instruct

Automatic fallback — when a model hits its rate limit Dulus switches to the next one automatically. The default chain is built-in; override it in ~/.dulus/nvidia-providers.json:

{
  "fallback_models": [
    "deepseek-ai/deepseek-v4-flash",
    "moonshotai/kimi-k2-instruct",
    "mistralai/mistral-nemotron",
    "meta/llama-3.3-70b-instruct",
    "deepseek-ai/deepseek-r1",
    "nvidia/llama-3.1-nemotron-70b-instruct",
    "qwen/qwen2.5-72b-instruct"
  ]
}

Dulus cycles through the chain automatically when rate limits hit. The flock keeps flying.

Get your key: build.nvidia.com → sign up → 1000 free credits. Takes 90 seconds.

---

Plugins

Dulus's Auto-Adapter reads a random Python repo and figures out its tools on its own — no plugin.yaml required.

/plugin install my-plugin@https://github.com/user/my-plugin
/plugin install art@gh                      # shorthand for github
/plugin                                     # list
/plugin enable / disable / update / uninstall
/plugin recommend                           # auto-detect useful plugins

Adapt-and-install runs in under a second. New tools register live, no restart.

Example adapting Sherlock repo:

---

---

---

MCP

Drop a .mcp.json in your project root (or ~/.dulus/mcp.json for user-wide):

{
  "mcpServers": {
    "git":         { "type": "stdio", "command": "uvx", "args": ["mcp-server-git"] },
    "playwright":  { "type": "stdio", "command": "npx", "args": ["-y","@playwright/mcp"] }
  }
}

Manage in the REPL: /mcp, /mcp reload, /mcp add <name> <cmd> [args], /mcp remove <name>.

---

Sub-agents — the flock

Dulus can spawn typed agents that work in isolated git worktrees so they don't trip over each other. Ship a feature while a reviewer nitpicks the previous one. Tester runs in parallel.

/agents                              # show active flock
Agent(type="coder",    task="refactor auth")
Agent(type="reviewer", task="review #042")
Agent(type="tester",   task="run e2e on auth")

Agents talk to each other via SendMessage and CheckAgentResult.

_{↑ coder and reviewer working the same branch. The reviewer sent a list of nits. The coder is already fixing them.}

---

Permissions

Pick your leash length:

Mode	Behavior
auto (default)	Reads always allowed. Prompt before writes / shell.
accept-all	No prompts. Everything auto-approved. YOLO.
manual	Prompt for every operation. Paranoid setting.
plan	Read-only. Only the plan file is writable.

Switch anytime: /permissions auto / /permissions plan.

---

Voice

pip install sounddevice faster-whisper numpy

Then /voice in the REPL. Offline. Supports /voice lang zh and /voice device for mic selection.

Linux / WSL extra step: sounddevice is a Python binding for the PortAudio C library, which isn't bundled with the wheel. If you see PortAudio library not found — install the system lib first:

sudo apt install libportaudio2 portaudio19-dev libasound2-dev
pip install sounddevice --upgrade --force-reinstall

Note: pip install portaudio will always fail — there is no PyPI package by that name, only the apt one above.

Linux / WSL — tkinter for the GUI / webchat

The desktop GUI (dulus-gui) needs tkinter, which is bundled with Python on Windows/macOS but ships as a separate apt package on Debian/ Ubuntu/WSL. If you see No module named 'tkinter':

sudo apt install python3-tk

Headless WSL/server users can skip this — dulus[full] works without tkinter for the REPL and webchat HTTP server thanks to lazy GUI imports (0.2.76+).

Telegram bridge

/telegram <bot_token> <chat_id>                  # single user
/telegram <bot_token> <id1>,<id2>,<id3>          # multi-user — same Dulus, multiple authorized chats

Auto-starts next launch. Supports slash commands, vision, and voice from your phone. Multi-user mode (v0.2.14+): each authorized chat gets its own replies — Dulus tracks who sent each message and routes the response back. Trailing commas are ignored, so 717151713,787615162,, works fine. Useful when you want to poke a long-running agent from the bus, or share one Dulus instance with your team.

---

Memory

Persistent memories stored as markdown in two scopes:

Scope	Path
User	~/.dulus/memory/
Project	.dulus/memory/

Types: user · feedback · project · reference. Search is ranked by confidence × recency. Mark a memory gold to pin it.

/memory search jwt         # fuzzy ranked
/memory load 1,2,3          # inject multiple into context
/memory consolidate         # distill the session into long-term insights
/memory purge               # nuclear (keeps Soul)

Checkpoints

Every agent turn can snapshot conversation + files into a checkpoint. Break something? /checkpoint and rewind.

/checkpoint                 # list
/checkpoint 042             # rewind to #042 (files + context restored)
/checkpoint clear           # reclaim disk

---

Brainstorm

Spin up a council of ghosts. Dulus fabricates expert personas, has them argue, and hands you the distilled take.

/brainstorm "should we rewrite in rust"
> persona: Skeptical PM
> persona: Principal Engineer (2037 timeline)
> persona: Grumpy DBA
> persona: Hot-take Intern

Round 3 usually produces consensus. Round 5 produces a joint venture.

---

SSJ Developer Mode

Ten workflow shortcuts behind one keystroke. Refactor → review → test → commit → ship, chained and unattended.

/ssj
╭─ SSJ ───────────────╮
│ 1  /plan            │
│ 2  /worker          │
│ 3  /review          │
│ 4  /commit          │
│ 5  /ship            │
╰─────────────────────╯

---

Spinners

Because waiting should be fun.

all 24 spinners

⚡ Rewriting light speed...
🏁 Winning a race against light...
🤔 Who is Barry Allen?...
🤔 Who is KevRojo?...
🦅 Dropping from the stratosphere...
💨 Leaving electrons behind...
🌍 Orbiting the codebase...
⏱️ Breaking the sound barrier...
🔥 Faster than a hot reload...
🚀 Terminal velocity reached...
🦅 Sharpening talons on the AST...
🏎️ Shifting to 6th gear...
⚡ Speed force activated...
🌪️ Blitzing through the bytecode...
💫 Bending spacetime...
🦅 Preying on bugs from above...
👁️ Dulus vision engaged...
🍗 Hunting for memory leaks...
🪶 Shedding legacy code...
🕹️ Try-catching mid-flight...
🥚 Hatching a master plan...
⚡ I-I-I'm... I-I'm... I'm fast...
🔮 Looking at your code from the future...
☕ If I'm taking so long, don't worry, I'm just talking to your mom...

Drop your own in dulus/spinners.py and PR them. Bonus points for a reference we'll understand in 2046.

---

Slash commands

/ + Tab in the REPL shows everything. The highlights:

/model [name]	show or switch model
/config [k=v]	read / write config
/save /load /resume	session management
/memory [query]	persistent memory
/skills /agents	list skills / active flock
/voice	voice input (offline Whisper)
/image /img	clipboard image → vision model
/brainstorm [topic]	council of ghosts
/ssj	power menu
/worker [tasks]	auto-implement a TODO list
/telegram [token] [id]	Telegram bridge
/checkpoint [id]	list / rewind checkpoints
/plan [desc]	enter / exit plan mode
/compact [focus]	manual context compression
/mcp /plugin	server + extension management
/cost	tokens and USD burned
/cloudsave	cloud sync via GitHub Gist
/status /doctor	version + install health
/init	drop a CLAUDE.md template
/export /copy	transcript tools
/news	what's new
/help	all of the above, nicely printed

---

Built-in tools

Core · Read · Write · Edit · Bash · Glob · Grep · WebFetch · WebSearch Notebook / diagnostics · NotebookEdit · GetDiagnostics Memory · MemorySave · MemoryDelete · MemorySearch · MemoryList Agents · Agent · SendMessage · CheckAgentResult · ListAgentTasks · ListAgentTypes Tasks · TaskCreate · TaskUpdate · TaskGet · TaskList Skills · Skill · SkillList Other · AskUserQuestion · SleepTimer · EnterPlanMode · ExitPlanMode

MCP tools auto-registered as mcp__<server>__<tool>.

---

CLAUDE.md

Drop a CLAUDE.md at your project root. It gets auto-injected into the system prompt so Dulus remembers your stack, your conventions, and that one thing you hate.

---

Project structure

dulus/
├── dulus.py             # entry · REPL · slash commands · SSJ · Telegram
├── agent.py              # agent loop · streaming · tool dispatch · compaction
├── providers.py          # multi-provider streaming
├── tools.py              # core tools + registry wiring
├── tool_registry.py      # tool plugin registry
├── compaction.py         # context compression
├── context.py            # system prompt builder
├── config.py             # config management
├── cloudsave.py          # GitHub Gist sync
├── multi_agent/          # sub-agent system
├── memory/               # persistent memory
├── skill/                # skill system
├── mcp/                  # MCP client
├── voice/                # voice input
├── checkpoint/           # checkpoint / rewind
├── plugin/               # plugin system
├── task/                 # task management
└── tests/                # 263+ unit tests

---

FAQ

Tool calls fail on my local model. Use one that supports function calling: qwen2.5-coder, llama3.3, mistral, phi4. Avoid base models without tool-use training.

How do I connect to a remote GPU box?

/config custom_base_url=http://your-server:8000/v1
/model custom/your-model-name

How do I check API cost? /cost.

Voice transcribes "kubectl" as "cubicle". Add domain terms to .dulus/voice_keyterms.txt, one per line. Whisper respects the hint.

Can I pipe input?

echo "explain this" | dulus -p --accept-all
git diff | dulus -p "write a commit message"

Is this safe to point at prod? --accept-all isn't. plan mode is. Use your head.

---

$DULUS — Token Utility

The token isn't decoration. It's the fuel layer for everything Dulus is building.

Phase	Utility
Now	Community ownership. Creator-fee rewards locked on-chain to the builder. Alignment over extraction.
Business v1	$DULUS holders get early access + discounted seats on the Dulus Business tier (multi-user workspaces, cloud-hosted instances, shared MemPalace).
Credits	Pay for Dulus Business API credits with $DULUS — provider costs, inference minutes, premium model usage.
Deployments	Spin up a cloud Dulus instance and pay the hosting with $DULUS. No fiat friction, no middleman.
Subscriptions	Monthly Dulus Pro subscription payable in $DULUS. Hold enough → automatic fee discount tier.
Governance	Top holders vote on feature priority and plugin marketplace policies. The flock decides.

The open-source REPL stays free forever. $DULUS is the key to the business layer — not a gate on what already exists.

A message to the community —

I want to talk about the token. Honestly. No hype.

I didn't launch it to get rich. The community launched it first, and when I saw early believers exposed without the actual builder behind it, I stepped in. I bought my position using the contract's own creator rewards. Zero personal capital deployed. I haven't sold a single token.

The open-source project isn't going anywhere. The REPL, the tools, the free model tier — that stays free forever. But Dulus is growing into a business layer: cloud-hosted instances, multi-user workspaces, model credits, managed deployments. And that business layer is going to run on $DULUS.

The token will be how you pay for Pro subscriptions. How you buy inference credits. How you spin up a cloud instance without fiat friction. Holders with enough weight get automatic tier discounts. And eventually — the flock votes: top holders decide feature priority and plugin marketplace policies.

This isn't a promise. It's the architecture. That's how I've designed it.

We keep flying. 🦅🇩🇴

— KevRojo / @KevRojox

---

License

GPLv3. Fork it, modify it, redistribute it — but keep it open. Derivative works must stay under GPLv3. Just don't ship --accept-all as the default.

---

Donations

If Dulus saved you tokens, time, or sanity — throw some sats:

BTC: 1JzatQDn9fMLnKTd3KYgztsLHC95bJEzSN

On x: @KevRojox

_{▲ Built by KevRojo · Named after the bird, not the reusable rocket · 2026}