NPMAI ECOSYSTEM · v3.0 · Free & Open Source

The Open Source
Agentic AI
Desktop Platform

21 integrated tools. Plan → Generate → Audit → Execute → Verify. A complete agent loop that rivals Claude Code — powered by free local LLMs.

↓ Download Free See it in action →
0
Downloads
21
Tools
Free
Forever
45+
LLMs
scroll
Live Demo

Watch the Agent Think

Click a task chip to see the full pipeline in motion

NPM Agent — NPMAI Ecosystem v3.0
MCP :7799
Navigation
💬 Agent
📋 History
🛠 Tools
⚙ Settings
👤 Founder
📖 Docs
MCP Server Active :7799
Ready0%
Hello! I'm NPM Agent. Describe any task — I'll plan it, generate secure code, and execute it on your machine. What would you like to automate?
Execution Logs
Capabilities

Built to Compete.
Free to Use.

Everything Claude Code does — on local models, with a GUI, for everyone.

🧠

Multi-LLM Agent Pipeline

4 separate LLMs for planning, code generation, security auditing, and verification — each with fallback chains. Not a chatbot. A real agent loop.

Plan → Generate → Audit → Execute → Verify
🔒

Dual-LLM Security Audit

Every generated script is reviewed by qwen2.5-coder:7b (fallback: falcon:7b) before any execution. 5 risk categories checked. Kill button always available.

Security First
🔄

Auto-Debug Loop (12 retries)

Execution fails? The agent captures the error, sends it back to CodeLlama, and rewrites or patches the code. Partial progress is preserved between retries.

Self-Healing
📁

File System Awareness

On startup, the agent scans Desktop, Downloads, Documents, Pictures, Videos, Music. Knows your files before you type. No paths needed.

Workspace Scanner
🔌

Embedded MCP Server

Start a TCP MCP server from the sidebar. 50+ tool endpoints exposed. Connect from Claude Desktop or any MCP client. Power your other projects.

MCP Protocol
🎤

Voice Input + subprocess

Speak your task. Code runs as a real child process — not exec(). Streams stdout live. Kill any script instantly. Real isolation, real safety.

Voice + Isolation
Tool Registry

21 Integrated Tools

All tools available to the agent automatically. No configuration needed. Just describe your task.

📧 EmailTool · Gmail SMTP/IMAP · Bulk CSV 📁 FileTool · Rename · Zip · Organize 📄 PDFTool · Merge · Split · Extract 🌐 WebTool · Scrape · Playwright · API 📊 SpreadsheetTool · CSV · Excel · Sheets ⭐ GitHubTool · Issues · Push · Clone 💬 SlackTool · Messages · Upload · Read 🎮 DiscordTool · Webhooks · Embeds 📱 WhatsAppTool · Instant Messages 📓 NotionTool · Pages · Databases 📧 EmailTool · Gmail SMTP/IMAP · Bulk CSV 📁 FileTool · Rename · Zip · Organize 📄 PDFTool · Merge · Split · Extract 🌐 WebTool · Scrape · Playwright · API 📊 SpreadsheetTool · CSV · Excel · Sheets ⭐ GitHubTool · Issues · Push · Clone 💬 SlackTool · Messages · Upload · Read 🎮 DiscordTool · Webhooks · Embeds 📱 WhatsAppTool · Instant Messages 📓 NotionTool · Pages · Databases
🐦 TwitterTool · Tweets · Timeline 🖥 SystemTool · Shell · Clipboard · Screenshot 🖼 ImageTool · Resize · OCR · Compress ⏰ SchedulerTool · Cron · Background 🎫 JiraTool · Issues · Sprints ✈ TelegramTool · Bot Messages 🔲 QRTool · Generate QR Codes 🎤 VoiceTool · TTS · STT 👁 WatcherTool · File Change Detection 📚 RAGTool · Large Doc Query · Summarize 🖧 SSHTool · Remote Commands · SFTP 🐦 TwitterTool · Tweets · Timeline 🖥 SystemTool · Shell · Clipboard · Screenshot 🖼 ImageTool · Resize · OCR · Compress ⏰ SchedulerTool · Cron · Background 🎫 JiraTool · Issues · Sprints ✈ TelegramTool · Bot Messages 🔲 QRTool · Generate QR Codes 🎤 VoiceTool · TTS · STT 👁 WatcherTool · File Change Detection 📚 RAGTool · Large Doc Query · Summarize 🖧 SSHTool · Remote Commands · SFTP
Agent Architecture

How the Agent Thinks

Every task goes through 6 stages. Each stage runs a different LLM for the right job.

01
🔍
Scan
Workspace scanner reads your file system — folders, files, paths — before anything else
→
02
🗺
Plan
llama3.2:3b breaks your task into 2-5 atomic, independently verifiable steps
→
03
⚡
Generate
codellama:7b writes Python for each step using the 21 tool templates as scaffolding
→
04
🔒
Audit
qwen2.5-coder checks 5 risk categories. BLOCK or ALLOW — no ambiguity
→
05
▶
Execute
Real subprocess.Popen — not exec(). stdout streams live. Kill anytime.
→
06
✓
Verify
A second LLM checks "did this actually complete?" — not just exit code 0
MCP Protocol

Power Your Other Projects

Start the embedded MCP server from the app sidebar. All 21 tools become available to Claude Desktop, your own LLMs, or any MCP client.

MCP Client · TCP · Port 7799
# Connect from Claude Desktop
# Add to mcp_config.json:
{
  "npm_agent": {
    "type": "tcp",
    "host": "localhost",
    "port": 7799
  }
}

# Or call directly:
import socket, json

def call_tool(tool, params):
  s = socket.socket()
  s.connect(("localhost", 7799))
  s.sendall(json.dumps({
    "tool": tool,
    "params": params
  }).encode() + b"\n")
  return json.loads(s.recv(65536))

# Example: send an email
result = call_tool("email_send", {
  "to": "teacher@school.edu",
  "subject": "Attendance Report",
  "body": "Today's report attached."
})
50+ Exposed Endpoints
💬
npmai_chat
Chat with any of 45+ models with named memory
🤖
npmai_run_task
Full agent pipeline from any external client
📧
email_send
Send email · email_bulk · email_inbox
⭐
github_issue
Create issues · push files · clone repos
💬
slack_send
Send messages · read channels · upload files
📚
rag_query
Query large documents via npmai Rag class
🖥
system_run
Execute shell commands on the host machine
📊
workspace_scan
Scan file system, returns full path map
The Builder

Meet the Founder

Sonu Kumar
Sonu Kumar 🇮🇳
Founder · NPMAI ECOSYSTEM · Bihar Viral Boy
Age 15 Bihar, India Kota, Rajasthan 434K+ Followers TEDx Speaker Allen 100% Scholar
⭐ GitHub 🐍 PyPI 🎤 TEDx 📘 FB
1.5M+
PyPI downloads
433K+
Social followers
TEDx
Speaker at 13
100%
Allen scholarship
45+
LLMs in ecosystem
3
Research papers 2026
🧒
Age 9
Started Teaching Nursery Kids
While in 4th grade, taught nursery children — planting the seed for education equity.
🔥
Age 11 — "Bihar Viral Boy"
Challenged Bihar's Chief Minister
Raised education & liquor ban issues. Went viral nationally. Received support from Cabinet Ministers, Bollywood actors & ALLEN Institute founder.
🎤
Age 13
TEDx Speaker
One of India's youngest TEDx speakers — rural education and using tech to bridge India's urban-rural divide.
💻
Age 13-14
Founded NPMAI ECOSYSTEM — 1.5M+ Downloads
Self-taught, zero CS background. Built entire ecosystem on free cloud infrastructure.
📄
2026
3 Research Papers Published
LARA · Representative Ideal Democracy · Ideal Administrative System Theory
Get Started

Download Free.
Run Instantly.

No API keys. No local GPU. No Ollama setup. Unzip and run.

1

Download ZIP

2

Unzip folder

3

Run .exe

4

Start automating

↓ Download NPM Agent v3.0
Windows · Free Forever · Open Source · No API Key Needed · NPMAI Ecosystem