nekomyadev/nudge repository overview

⁠Nudge

Typed, replayable, budget-aware programming language for LLM agents.

Compiles to Python & TypeScript.

⁠Features

• Typed LLM Calls — Output schema is a language type; violations trigger automatic repair
• Deterministic Replay — Full, hybrid, and live modes; traces are git-friendly JSONL
• Budget Contracts — Per-call, per-run, and per-repair USD ceilings
• Effect System — Pure / LLM / Tool / IO effects inferred
• Native Parallelism — par map, par race, par all
• Real Providers — OpenAI, Anthropic, Gemini, Groq, MiMo, Mistral, Ollama

⁠Quick Start

# Pull the image
docker pull nekomyadev/nudge:latest

# Run nudgec
docker run -it --rm nekomyadev/nudge nudgec --help

# Mount your project and run
docker run -it --rm -v $(pwd):/workspace nekomyadev/nudge nudgec check hello.ndg

# Build and run with fake provider (no API key needed)
docker run -it --rm -v $(pwd):/workspace -e NUDGE_PROVIDER=fake nekomyadev/nudge sh -c "nudgec build hello.ndg && python3 out/hello.py"

⁠Example

type Finding = { claim: string, source: Url, confidence: float @range(0, 1) }

fn analyze(q: string) -> [Finding] uses LLM {
    llm"""Extract findings about {q}"""
    with { schema: [Finding], model: "anthropic:sonnet-4.6", budget: 0.03 USD }
}

⁠Tags

• latest — Latest stable release
• 1.2.0 — Version 1.2.0

⁠Links

• GitHub⁠
• VS Code Extension⁠

⁠Security

This image is regularly scanned for vulnerabilities. Current status:

• Debian packages: 8 known (base image, awaiting upstream fix)
• Node.js packages: 0 known (updated)
• Python packages: 0 known (updated)

⁠License

Proprietary — see LICENSE⁠