| Requirement | Minimum | Notes |
|---|---|---|
| Node.js | 20+ | For all Hydra modules |
| PowerShell | 7+ | For launchers and agent heads |
| AI CLI (at least one) | gemini, codex, or claude |
- Gemini CLI:
npm install -g @google/gemini-cli - Codex CLI:
npm install -g @openai/codex - Claude Code:
npm install -g @anthropic-ai/claude-code
# Clone to a dedicated directory
git clone <repo-url> C:\path\to\Hydra
cd C:\path\to\Hydranpm install# From this repo checkout
pwsh -File .\bin\install-hydra-cli.ps1
# Alternative:
npm run install:globalThis adds a real hydra command to your npm global bin (no PowerShell profile function required).
# Check CLI wiring
hydra --help
# Check that the daemon can start
node lib/orchestrator-daemon.mjs helpcd E:\Dev\YourProject
hydra-client initThis creates the docs/coordination/ directory with:
AI_SYNC_STATE.json- Shared state fileAI_SYNC_LOG.md- Activity logAI_ORCHESTRATOR_EVENTS.ndjson- Event stream
pwsh -File C:\path\to\Hydra\bin\install-hydra-profile.ps1Use this only if you want the old profile-function based command. The global npm install already provides hydra.
Uninstall: pwsh -File C:\path\to\Hydra\bin\install-hydra-profile.ps1 -Uninstall
Create a distributable tarball:
npm run packageThis emits dist/hydra-<version>.tgz. Install it on any machine with Node:
npm install -g .\dist\hydra-<version>.tgznpm install
npm run build:exe
.\dist\hydra.exe --helpThis produces a single-file binary at dist/hydra.exe that includes Node runtime + Hydra code.
Notes:
- No Node install is required on the target machine.
- Standalone mode supports normal operator/daemon/client flows.
--fullmode is disabled in standalone exe builds (PowerShell multi-terminal launcher is repo-install only).
Add these scripts to your project's package.json:
{
"scripts": {
"hydra:start": "node /path/to/Hydra/lib/orchestrator-daemon.mjs start",
"hydra:stop": "node /path/to/Hydra/lib/orchestrator-client.mjs stop",
"hydra:status": "node /path/to/Hydra/lib/orchestrator-client.mjs status",
"hydra:summary": "node /path/to/Hydra/lib/orchestrator-client.mjs summary",
"hydra:stats": "node /path/to/Hydra/lib/orchestrator-client.mjs stats",
"hydra:usage": "node /path/to/Hydra/lib/hydra-usage.mjs",
"hydra:model": "node /path/to/Hydra/lib/orchestrator-client.mjs model",
"hydra:go": "node /path/to/Hydra/lib/hydra-operator.mjs mode=auto",
"hydra:council": "node /path/to/Hydra/lib/hydra-council.mjs",
"hydra:next": "node /path/to/Hydra/lib/orchestrator-client.mjs next",
"hydra:add": "node /path/to/Hydra/lib/orchestrator-client.mjs task:add",
"hydra:update": "node /path/to/Hydra/lib/orchestrator-client.mjs task:update",
"hydra:handoff": "node /path/to/Hydra/lib/orchestrator-client.mjs handoff",
"hydra:launch": "pwsh -NoProfile -ExecutionPolicy Bypass -File /path/to/Hydra/bin/hydra-launch.ps1",
"hydra": "pwsh -NoProfile -ExecutionPolicy Bypass -File /path/to/Hydra/bin/hydra.ps1"
}
}| Variable | Default | Description |
|---|---|---|
AI_ORCH_HOST |
127.0.0.1 |
Daemon bind host |
AI_ORCH_PORT |
4173 |
Daemon bind port |
AI_ORCH_URL |
http://127.0.0.1:4173 |
Daemon URL for clients |
AI_ORCH_TOKEN |
(none) | Optional auth token |
HYDRA_PROJECT |
(cwd) | Override target project |
HYDRA_CLAUDE_MODEL |
(config) | Override Claude model |
HYDRA_GEMINI_MODEL |
(config) | Override Gemini model |
HYDRA_CODEX_MODEL |
(config) | Override Codex model |
OPENAI_API_KEY |
(none) | Concierge primary provider (OpenAI models) |
ANTHROPIC_API_KEY |
(none) | Concierge fallback provider (Anthropic models) |
GEMINI_API_KEY |
(none) | Concierge fallback provider (Google Gemini models) |
GOOGLE_API_KEY |
(none) | Alternative to GEMINI_API_KEY for Google provider |
"Not a valid project directory" Hydra needs at least one project marker file (package.json, .git, CLAUDE.md, etc.) in the target directory.
Concierge unavailable
Set at least one API key: OPENAI_API_KEY, ANTHROPIC_API_KEY, or GEMINI_API_KEY/GOOGLE_API_KEY. The concierge uses a multi-provider fallback chain — it will use whichever providers have keys available. Without any key, the operator falls back to direct dispatch (no conversational layer).
Agent CLI not found
Ensure the agent CLI is installed globally and available in PATH. Run node lib/sync.mjs doctor to check.
Port already in use
Change the port: node lib/orchestrator-daemon.mjs start port=4174