DeepParallel

A multi-model agentic coding CLI with cross-model Guardian review. Many models check the work; you ship with a second opinion. Served via Crowe Logic.

Install

uv tool install deepparallel        # recommended
# or
pipx install deepparallel --python python3.13

Then run deepparallel (or the short alias dp).

Note: on systems with a broken Homebrew Python 3.14, bare pipx install may fail to find a usable interpreter - use uv tool install or pin --python.

From source

uv venv
uv pip install -p .venv -e .

Configure

Free is bring-your-own-key, and the backend is auto-detected from whatever credentials the machine already has (a .env file in the working directory is loaded automatically). Detection order: Azure creds, then an OpenAI key, then an OpenAI-compatible endpoint, then a local Ollama. With none of these, dp prints setup guidance instead of starting.

# OpenAI
OPENAI_API_KEY=sk-...

# Local Ollama: install from https://ollama.com and start it - no other
# config needed; the first installed model is used unless
# DEEPPARALLEL_MODEL is set.

# Any OpenAI-compatible endpoint (incl. the Crowe Logic Foundry control plane)
FOUNDRY_BASE_URL=https://<control-plane>
FOUNDRY_API_KEY=<token>

# Azure OpenAI
AZURE_CORE_ENDPOINT=https://<resource>.openai.azure.com
AZURE_CORE_API_KEY=<key>
DEEPPARALLEL_API_VERSION=2024-08-01-preview   # optional

Pin a backend explicitly with DEEPPARALLEL_BACKEND=openai|ollama|foundry|azure|crowe (or [backend] backend = "..." in ~/.config/deepparallel/config.toml).

Use

deepparallel                 # interactive agent chat
deepparallel run "question"  # one-shot, pipe-friendly (answer on stdout)
deepparallel tools           # list the agent's tools
deepparallel info            # model + backend status
deepparallel doctor          # diagnose config + reachability
deepparallel run --no-tools "..."   # plain chat, no tools
deepparallel run --yes "..."        # auto-approve tool actions
deepparallel review <file|--diff>   # cross-model review as a CI gate (Pro)
deepparallel audit <file>           # supply-chain gate: catch hallucinated deps (Pro)
deepparallel research conduit       # latent-relay research demo (needs [research] extra)

Supply-chain gate

LLMs invent package names that don't exist — and attackers register those names ("slopsquatting"). deepparallel audit <file> extracts the dependencies a file introduces (imports, requirements.txt, package.json) and checks each against the real registry (PyPI / npm), flagging any the registry has never seen. Exit 0 clean, 2 if a likely-hallucinated package is found — so it gates a commit or PR. The Guardian also runs this automatically on every edit: a hallucinated import forces a confirmation even under --yes.

Fusion (stacking models for stronger output)

deepparallel can stack the answerer with a separate reasoning model. All modes compose hosted backends (no GPU/weight-merging), so they are API-call stacking.

deepparallel run --fuse reason "hard question"     # reasoner thinks, answerer answers
deepparallel run --fuse escalate "question"        # answer first; escalate to reasoner only if unsure
deepparallel run --deep "question"                 # heavy: many models in parallel + a judge (slow)
deepparallel run --dual "A,B" "question"           # compare two deployments side by side
deepparallel run --dual "A,B" --synth "question"   # ...and synthesize a merged answer

--fuse also works in interactive chat. Set a default with DEEPPARALLEL_FUSION=reason.

Fusion-native UX (what single-model agents cannot do)

• Guardian review - before an edit (write_file / edit_file / ast_replace_symbol) is applied, a second model reviews the diff and its verdict (safe / risky: ... / bug: ...) is shown in the confirm card. Advisory: you still approve. Toggle with DEEPPARALLEL_GUARDIAN; pick the reviewer with DEEPPARALLEL_GUARDIAN_DEPLOYMENT.
• Consensus + divergence - run --deep prints a consensus: chip from cross-model agreement (agreement, not correctness), and on low agreement lists the dissenting candidates.
• Live dial - in interactive chat, /fast, /fuse, /escalate switch the fusion mode mid-session (shown in the prompt); /deep runs the next prompt as a multi-model query.

Agent and tools

deepparallel is an agent: it can call tools to inspect and change your project.

• Read-only (run automatically): read_file, list_dir, glob, grep, ast_symbols, ast_show_symbol, web_fetch, web_search, analyze_image.
• Mutating / executing (require confirmation): write_file, edit_file, ast_replace_symbol, run_shell, run_code, open_path (open a file, folder, or URL in the OS default app - e.g. an HTML report in the browser).

In interactive chat, type /auto to toggle auto-approve (tools run without asking; edits outside the project and unknown dependencies still confirm), or start with deepparallel --yes.

web_search needs DEEPPARALLEL_SEARCH_API_KEY; analyze_image works out of the box on a multimodal deployment (override with DEEPPARALLEL_VISION_DEPLOYMENT).

In interactive chat, mutating actions prompt for y/n. In run (non-interactive) they are denied unless you pass --yes. ast_* tools are multi-language via tree-sitter; run_code executes in a Docker sandbox when available, else a timeboxed local subprocess.

Configuration reference

DeepParallel is served via Crowe Logic infrastructure. https://crowelogic.com