@ousia/indus-code — Claude-Code-level AI coding agent

Package name: @ousia/indus-code · Binaries: indus, indus-code, indus-server, indus-mcp

Install

# Global install — gives you all four binaries
npm install -g @ousia/indus-code

# Or one-shot, no install
npx @ousia/indus-code "fix the bug in app.py"

What each command does

| Command | What it does | |---|---| | indus | Thin chat REPL. Streams a model response. One-shot if you pass a prompt, REPL if you don't. | | indus-code | The full coding agent — TUI, local tools, worktree, sub-agents, retry, MCP. | | indus-server | Local HTTP daemon (for IDE integration or indus-code --connect). | | indus-mcp | Exposes the agent as a Model Context Protocol server. |

Quickstart

# Set a provider key (NVIDIA gives free credits)
export INDUS_NVIDIA_API_KEY=nvapi-...

# One-shot: ask a question
indus "what is 2+2?"

# REPL: chat interactively
indus

# Full coding agent
indus-code "refactor the auth module"
indus-code            # TUI

# Run a local daemon and connect
indus-server --port 7333 --workspace .
indus-code --connect http://127.0.0.1:7333 "fix the failing test"

# Expose as MCP (works with Claude Desktop, Cursor, etc.)
indus-mcp

Features

• TUI (prompt_toolkit + rich) with live token streaming
• Local tools — list_files, read_file, write_file, edit_file, search_code, run_command, apply_patch, web_fetch
• Sub-agents — research / edit / review roles, parallel asyncio.gather dispatch
• Worktree isolation — every change is a real git worktree, easy to discard
• INDUS.md memory — project-aware context
• Provider-agnostic — talks to NVIDIA, Anthropic, OpenAI, OpenRouter, Groq, Together, Mistral, Cohere, Perplexity, Fireworks, DeepSeek, xAI, AI21, plus Hermes (control plane), OpenHands, MonkeyCode
• MCP — exposes the agent as a Model Context Protocol server
• Resilient — bounded exponential backoff with jitter, time-context injection, scoped tool registration, code-mode for nested tool dispatch

Configuration

Set provider API keys via environment variables. Indus resolves them through a layered credential provider (env → encrypted store → settings) so rotations take effect on the next request.

export INDUS_NVIDIA_API_KEY=nvapi-...
export INDUS_ANTHROPIC_API_KEY=sk-ant-...
export INDUS_OPENAI_API_KEY=sk-...
export INDUS_HERMES_API_KEY=hk-...              # control plane

Inside the TUI

• Type a message and press Enter
• Ctrl-C to interrupt
• /help for slash commands
• /compact to summarise the conversation
• /resume to load a saved session

Why a Node wrapper?

The agent itself is Python (FastAPI + the indus_cli package). This npm package is a thin shim that:

1. Ensures Python 3.10+ is available on the system.
2. On first run, installs the indus-cli Python package via pip (PyPI) or git+https.
3. Forwards all indus / indus-code arguments to the right Python entry point.

If you'd rather install the Python package directly:

pipx install indus-cli
indus-code

License

Apache 2.0 — see LICENSE.