dialecticalagents

Run the dialectical and dialectical-cli commands from npm.

This package vendors source from libs/dialecticalagents, builds an isolated Python runtime at install time, and launches the same dialectical CLI flow from that local runtime.

Install

npm install -g dialecticalagents
# or
pnpm add -g dialecticalagents

Local usage:

npm install dialecticalagents
npx dialectical --help

DeepSeek-First Start

export DEEPSEEK_API_KEY="your_key_here"

dialectical --default-model deepseek:deepseek-chat
dialectical

Full Behavior: Keys, Models, and Roles

API key strategy

• You can set multiple provider keys if you use mixed-provider role configs.
• You can also run all roles with one DEEPSEEK_API_KEY.
• If proposer/critic/synthesizer are all DeepSeek models, one key is enough.
• That same single key also works across dialectical modes (auto, autocoding, reasoning, review, council) when those flows use DeepSeek models.

Default model behavior

If no explicit model is provided, model resolution prioritizes configured default and recent model settings, then credential-based fallback. When DEEPSEEK_API_KEY is present, DeepSeek is selected first.

Role controls

• --model provider:model
• --player-model
• --coach-model
• --synthesizer-model

Startup UX Notes

• First launch can look idle for a short period.
• This is expected while the runtime and first dialectical loop initialize.
• Let it run before interrupting.

Provider Status

• Multi-provider integration is available via LangChain providers.
• This npm distribution is currently confirmed in real usage with DeepSeek API.

Requirements

• Python 3.11+
• python3 or python on PATH
• Network access during install (dependencies are resolved then)

Environment Variables

Runtime:

• DIALECTICAL_PYTHON: Force specific Python executable.
• DIALECTICAL_NPM_DISABLE_INSTALL=1: Skip install-time Python setup.
• DIALECTICAL_NPM_FORCE_INSTALL=1: Force reinstall of bundled Python package.

DeepSeek defaults:

• DEEPSEEK_API_KEY: DeepSeek credential.
• DEEPSEEK_MODEL: Optional default DeepSeek model (default: deepseek-chat).

How It Works

1. prepack syncs source from libs/dialecticalagents into python-src/.
2. postinstall creates runtime/venv and installs ./python-src.
3. dialectical and dialectical-cli proxy to binaries in that venv.

Source

• Repository: https://github.com/Hmbown/dialecticalagents
• Python source path in repo: libs/dialecticalagents