✦ Namo AI

Autonomous AI Coding Agent for your terminal.

Namo reads, writes, edits, runs, tests, debugs, and fixes your projects — end-to-end, like a professional coding agent.

╭──────────────────────────────────────╮
│              NAMO AI                 │
│        Autonomous Coding Agent       │
╰──────────────────────────────────────╯

Install

npm install -g namo-ai

Requires Python 3.9+ — Namo's engine runs on Python. Install it from python.org.

Quick Start

# Interactive agent
namo

# One-shot task
namo "build a FastAPI REST API"

# Fix your project
namo fix

# Review code
namo review src/

Commands

| Command | Description | |---|---| | namo | Interactive agent shell | | namo chat | Chat mode | | namo agent <task> | Run an autonomous task | | namo ask <question> | Ask a question | | namo fix | Autonomous repair loop | | namo debug <file> | Debug a file or error | | namo review <path> | Code review | | namo refactor <path> | Refactor code | | namo test | Run tests | | namo build | Build the project | | namo explain <file> | Explain code | | namo search <query> | Search project | | namo models | List available models | | namo providers | List providers | | namo diff | View/rollback changes | | namo sessions | List sessions | | namo resume | Resume last session | | namo memory | Show memory | | namo doctor | Environment diagnostics | | namo git <subcmd> | Git integration | | namo version | Show version |

Providers & Models

Namo ships with a FreeProvider supporting:

• NVIDIA — nemotron-3-super-120b-a12b, nemotron-3-ultra-550b-a55b, minimax-m3
• TokenRouter — deepseek-v4-pro-0813-free
• Groq — qwen3.6-27b
• Ollama — gpt-oss:120b:cloud, gemma4:cloud, nemotron-3-nano:30b-cloud

Plus a CustomProvider for any OpenAI-compatible / Anthropic / local API.

API Keys

Set via environment variables or .env:

NVIDIA_API_KEY=nvapi-...
TOKENROUTER_API_KEY=...
GROQ_API_KEY=gsk_...
OLLAMA_HOST=http://localhost:11434

Keys are never printed, logged, or stored in plaintext.

License

MIT