npmai-agents
Production-grade autonomous AI agent framework with 1,371 tools across 100 classes and a 5-role LLM pipeline — built on the NPMAI ECOSYSTEM.
Decision gist · record as of 2026-08-14
Yes, if you want to experiment with autonomous AI agents or automate complex multi-step tasks. The framework is actively maintained, has low install friction, carries no license restrictions, and offers genuine value through its pre-compiled tool registry and free LLM tier. Start with the minimal install and upgrade to `[full]` only if you need all 1,371 tools available immediately. Verify that the specific tools and LLM providers you need are stable and well-documented before committing to production use.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.9 or later.
- LLM provider credentials (API keys) must be saved via CLI for non-NPMAI providers; NPMAI free tier requires no setup.
- Low friction install with pure Python wheel distribution.
License · maintenance · safety
MIT (permissive) — MIT license is permissive — you can use this in commercial projects, modify it freely, and distribute it with minimal restrictions. No copyleft obligations or patent clauses.
last release 2026-07-07 (38 days) · last repo commit 2026-07-19 · 1 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 236,319 downloads/mo, #8,986 on PyPI
Alternatives
Verify before relying
pip install npmai_agents
from npmai_agents import AgentBrain
# Run a task through the 5-role pipeline
agent = AgentBrain()
result = agent.run("Analyze my sales.csv and create a revenue report")- Whether the 1,371 tools and 100 classes are all functional and well-maintained in the current release
- Real-world latency and reliability of the 5-role pipeline on complex multi-step tasks
- How tool dependency auto-installation at runtime handles version conflicts or missing system libraries
- Whether the framework handles long-running tasks and recovery from transient LLM provider failures
What it is and what it does
npmai_agents is an autonomous AI agent framework that breaks down plain-English tasks into a structured 5-stage pipeline: Planner (breaks down the task), Tool Manager (selects relevant tools), Coder (generates execution code), Auditor (security review), and Verifier (validates results). The core innovation is pre-compiled tool knowledge — each of the 1,371 tools across 100 classes ships with structured metadata that the pipeline reads on-demand, eliminating hallucination on API shapes and method signatures.
You can run tasks via CLI (`npmai run "your task"`) or programmatically by importing AgentBrain and other classes. The framework supports 12 LLM providers including free NPMAI-hosted models, OpenAI, Groq, Anthropic, Gemini, and local Ollama. By default all roles use free NPMAI models with zero setup; you can override any role's provider and model per-call. Tool dependencies auto-install at runtime unless you pre-install the full extra (`pip install npmai_agents[full]`), keeping the base install lightweight.
Use it for
- Automate multi-step business workflows (e.g., scrape data, analyze it, generate reports, email results) without writing orchestration code
- Build desktop automation tasks that interact with files, APIs, and local tools using natural language instead of shell scripts
- Prototype and iterate on agentic AI solutions using free LLM models before committing to paid providers
- Execute security-audited code generation tasks where the Auditor role reviews generated code before execution
- Integrate with external services (Stripe, GitHub, Slack) via pre-built tool classes without managing API client libraries individually
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you want to experiment with autonomous AI agents or automate complex multi-step tasks.
The framework is actively maintained, has low install friction, carries no license restrictions, and offers genuine value through its pre-compiled tool registry and free LLM tier. Start with the minimal install and upgrade to `[full]` only if you need all 1,371 tools available immediately. Verify that the specific tools and LLM providers you need are stable and well-documented before committing to production use.
Install
npmai-agents on PyPI
Before you install
Low friction install with pure Python wheel distribution. Active maintenance with recent release (38 days ago) and ongoing commits. Five runtime dependencies (npmai, requests, cryptography, typer, rich) are all stable, widely-used libraries with minimal transitive overhead.
Requires Python 3.9 or later. LLM provider credentials (API keys) must be saved via CLI for non-NPMAI providers; NPMAI free tier requires no setup.
License in practice
MIT license is permissive — you can use this in commercial projects, modify it freely, and distribute it with minimal restrictions. No copyleft obligations or patent clauses.
Quickstart
pip install npmai_agents
from npmai_agents import AgentBrain
# Run a task through the 5-role pipeline
agent = AgentBrain()
result = agent.run("Analyze my sales.csv and create a revenue report")Verify before relying
- Whether the 1,371 tools and 100 classes are all functional and well-maintained in the current release
- Real-world latency and reliability of the 5-role pipeline on complex multi-step tasks
- How tool dependency auto-installation at runtime handles version conflicts or missing system libraries
- Whether the framework handles long-running tasks and recovery from transient LLM provider failures
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.9 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 5 packagesnpmairequestscryptographytyperrich |
| Maintenance | Actively maintained 38 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 236,319 / month, #8,986 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersIntended Audience :: Science/ResearchLicense :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.9Topic :: Office/Business :: SchedulingTopic :: Scientific/Engineering :: Artificial IntelligenceTopic :: Software Development :: Libraries :: Python ModulesTopic :: System :: Systems Administration |
Evidence: npmai_agents-1.0.2-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “task automation with ai”
- npmai-agentsAutonomous AI agent framework that executes plain-English tasks…
- mistralai-workflowsMistral Workflows is a Python SDK for building AI-powered workflows…
- browser-useBrowser Use is a Python library that lets AI agents automate web…
Give your agent the search over MCP, or paste the wish link into any chat.
More Python Modules packages
Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.
Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.
Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.
PyYAML parses and emits YAML 1.1 data format, enabling serialization and deserialization of configuration files and Python objects to and from human-readable YAML text.
Pydantic validates Python data structures against type hints, coercing and checking input at runtime to ensure it matches a declared schema.
Provides reusable metadata objects for use with PEP-593 `typing.Annotated` to express common constraints like bounds, collection sizes, and predicates on types.
Install it if you use or build libraries that need to express type constraints in a standardized, inspectable way—or if you want to annotate your own types with…
Provides runtime tools to inspect and introspect Python type annotations, enabling programmatic examination of type hints at execution time.
See also npmai · autogen · praisonaiagents · ai-parrot · PraisonAI · genagent · llm · kosong · litellm-enterprise · stirrup