Installation

Prerequisites

For the prebuilt developer-preview archive:

• curl
• tar
• shasum for checksum verification
• a supported preview target listed below

Rust is not required to install DUUMBI from the prebuilt archive. A system C compiler may still be needed when compiling DUUMBI programs because native program builds link through the platform toolchain.

Developer preview install

DUUMBI v0.4.1-preview is distributed as prebuilt GitHub Release archives.

Platform	Target	Status
macOS Apple Silicon	aarch64-apple-darwin	Required preview target
Linux x86_64	x86_64-unknown-linux-gnu	Required preview target
Linux ARM64	aarch64-unknown-linux-gnu	Extra preview target

Download the archive for your platform from the v0.4.1-preview release and verify it with the published checksum file:

DUUMBI_VERSION=v0.4.1-preview
DUUMBI_TARGET=<target>

curl -LO "https://github.com/hgahub/duumbi/releases/download/${DUUMBI_VERSION}/duumbi-${DUUMBI_VERSION}-${DUUMBI_TARGET}.tar.gz"
curl -LO "https://github.com/hgahub/duumbi/releases/download/${DUUMBI_VERSION}/checksums.txt"
shasum -a 256 --ignore-missing -c checksums.txt

tar xzf "duumbi-${DUUMBI_VERSION}-${DUUMBI_TARGET}.tar.gz"
export PATH="$PWD/duumbi-${DUUMBI_VERSION}-${DUUMBI_TARGET}:$PATH"

duumbi --version

Keep the extracted release directory together. The CLI expects the packaged runtime/ tree beside the executable when linking native DUUMBI programs.

Note

No macOS Intel or Windows preview archive is published for this release path. Build from source on macOS Intel. Native Windows is unsupported. This developer preview also does not provide crates.io installation, Homebrew, apt, winget, signed installers, notarized packages, or auto-update support.

Native Windows support was retired to focus development and validation resources on Linux and macOS. It may be reconsidered when the product is more mature; there is no return date or WSL support commitment.

The final Windows-capable source is preserved at the annotated tag windows-support-final-2026-09-10, commit 52931c91d9fc6f7a541e1c250e0837a9980dd46b. This is a historical source snapshot, not a Windows binary release or maintained branch. See #800 for the decision.

Verify a smoke project

Create and run a small project with the installed preview binary:

duumbi init smoke
cd smoke
duumbi build
duumbi run

Build from source

Use the source path for contributing or local development on Linux and macOS, including Intel Macs without a preview archive.

Source build requirements:

• Rust (stable, latest) - install via rustup.rs
• C compiler - cc on PATH
  • macOS: Xcode Command Line Tools (xcode-select --install)
  • Ubuntu/Debian: sudo apt install build-essential
  • Fedora: sudo dnf install gcc

git clone https://github.com/hgahub/duumbi.git
cd duumbi
cargo build --release
./target/release/duumbi --version

For local development, you can install the checked-out source tree into your Cargo bin directory:

cargo install --path .

The full test suite is useful before contributing:

cargo test --all

Provider setup

Query, Agent, and Intent features need a configured provider. Use the provider setup flow when available:

duumbi provider list
duumbi provider add anthropic ANTHROPIC_API_KEY

Project configuration uses [[providers]] entries with roles:

[[providers]]
provider = "anthropic"
role = "primary"
api_key_env = "ANTHROPIC_API_KEY"

[[providers]]
provider = "minimax"
role = "fallback"
api_key_env = "MINIMAX_API_KEY"

Set API keys in your environment:

export ANTHROPIC_API_KEY="sk-ant-..."

Tip

Model selection is handled by DUUMBI’s provider catalog and routing policy. See the config reference and provider catalog for supported provider keys and compatibility notes.

Next steps

Now that DUUMBI is available locally, create your first project or read how Query mode keeps exploration read-only by default.