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, Windows, or any other unsupported target. This developer preview also does not provide crates.io installation, Homebrew, apt, winget, signed installers, notarized packages, or auto-update support.

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, local development, or unsupported preview targets.

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.