Quickstart

Go from zero to a protected agent in under two minutes — either with the automated CLI installer or by installing an SDK manually.

Automated CLI installer

Run npx moven-ai-cli init inside your AI project directory. Moven inspects dependencies, detects your framework, extracts model definitions, and generates a ready-to-use configuration file.

terminal
bash
npx -y moven-ai-clilatest init
What the installer does automatically
  • Detects agent frameworks: LangChain / LangGraph, Vercel AI SDK, LlamaIndex, CrewAI, AutoGen.
  • Scans source files for active model strings (gpt-4o, claude-3-5-sonnet, gemini-2.5-flash).
  • Opens the browser pairing authentication page.
  • Writes moven.config.ts with your exact agent identity.
  • Saves your authenticated MOVEN_API_KEY into the local .env.

Manual installation

Prefer manual setup? Moven ships native, zero-dependency in-process SDKs for Python and Node.js.

Python SDK (PyPI)pypi.org/project/moven-sdk
terminal
bash
pip install moven-sdk
Node.js / TypeScript SDK (NPM)npmjs.com/package/moven-sdk
terminal
bash
npm install moven-sdk

First protected run

Decorate a tool with the breaker and execute. Any runaway loop is killed in-process, and the trace appears in your dashboard immediately — tokens, cost and money saved included.

agent.py
python
from moven_sdk import MovenCircuitBreaker, BreakerConfig breaker = MovenCircuitBreaker(BreakerConfig(    project_id="your-project-id",    max_repeats=3,    spend_ceiling_usd=2.00,    model_name="openai/gpt-4o",)) breaker.protectdef execute_sql_query(query: str):    return db.execute(query)

Next, connect your model provider on the Provider Adapters page, or fine-tune trip formulas under Heuristics.