Open Source Research & Development Community

Free LLMs.
Powering AI Agents
Powering AI Projects

NPMAI ECOSYSTEM is an open-source community where developers and researchers contribute to AI and civic tools — without worrying about money. 45+ LLMs, a production RAG pipeline, persistent memory, and original research. All free. Forever.

GitHub ↗
install
$pip install npmai
3.5M+
npmai downloads
116.3K+
npmai_agents downloads
45+
LLM models
10+
Live projects
$0
Monthly cost
🚀 Just Launched
npmai_agents — 1,371 Tools · 100 Classes · 5-Role Autonomous Pipeline
NPMAI ECOSYSTEM's flagship product: a production-grade desktop AI agent framework with 1,371 verified tools across 100 classes — the largest open-source local tool registry ever built — orchestrated by a 5-role autonomous LLM pipeline (Planner → Tool Manager → Coder → Auditor → Verifier), Fernet-encrypted credential storage, LARA RAG integration, 12 supported LLM providers, and up to 12 auto-retries per step. Give it any task in plain English — it figures out the rest. Already at 116.3K+ downloads.
pip install npmai_agents
1,371
Tools
100
Classes
5
LLM roles
116.3K+
Downloads
python
from npmai import Ollama llm = Ollama( model="llama3.2", temperature=0.5 ) response = llm.invoke("Explain NPMAI in one sentence.") print(response)

NPMAI Ecosystem

Every project is open source, running in production on free infrastructure. Click Understand Project on any card for a full deep-dive — for both technical and non-technical readers.

System Architecture

How requests flow through the NPMAI ecosystem — from your code to the LLM and back. Three interactive diagrams below.

⚡ LLM Request Flow
📚 RAG Pipeline (LARA)
⚖ Load Balancer
🐍 Your Python code llm.invoke("...")
📦 npmai package Ollama class
🌐 Primary LB HuggingFace Space
Fallback LB If primary fails
🦙Llama 3.2
💎Gemma 3
🔮Mistral 7b
🧮Qwen 2.5
41 more
← response flows back to your code
INGESTION PATH
📄Your files (PDF / Image / Video / TXT)
🔍OCR + Whisper extraction Tesseract · OpenCV · Whisper base
Chunking (1000 chars / 200 overlap)
🧲BGE-small-en-v1.5 embeddings
💾FAISS HNSW index (local or Supabase)
LARA RETRIEVAL PATH (5 PHASES)
Your query string
🎯Ph 1&2 — ANN ~200 candidates O(log N)
🏆Ph 3 — Quality gate S ≥ 0.3 (Dynamic K)
Ph 4 — Latency governor (formally proven)
🪟Ph 5 — Sliding window 3-chunk batches
LLM answer — 66% fewer API calls
🐍Python SDK npmai.Ollama
🌐Direct HTTP Any language
🔗LangChain / CrewAI Drop-in LLM
PRIMARY LOAD BALANCER
npmaiecosystem-load_balancer.hf.space
failover
FALLBACK LOAD BALANCER
npmaiecosystem-loadbalancerfallback.hf.space
Redis · Lua atomic check-and-increment · concurrent request tracking
45+ Model Endpoints (Community Contributed)
llama3.2gemma3:12bqwen2.5-coder:7b codellama:7b-instructmistral:7bvicuna:7b gemma2:9bphi3:mediumfalcon:7b-instruct deepseek-r1:7bphi4:14bgemma3:4b + 33 more

Technical research from the NPMAI ECOSYSTEM. Click any paper to expand.

Social and governance research. Click any paper to expand.

Chemistry research from the NPMAI ECOSYSTEM Research Chemistry Department. Click the paper to view the full research.

Chemistry · Advanced Materials · Metallurgy · 2026
Direct Aluminothermic Production of Ti-6Al-4V Alloy
A Novel Semi-Continuous Three-Chamber Reactor with Hybrid Deoxidation — An Integrated Alternative to the Kroll Process
Author: Sampatirao Trilok Varma (Trilok Varma) HOD, Research Chemistry Department NPMAI ECOSYSTEM · 2026

This paper presents a comprehensive technical case for direct semi-continuous aluminothermic co-reduction of TiO₂ and V₂O₅ to produce Ti-6Al-4V alloy in a single integrated three-chamber reactor system — bypassing chlorine chemistry and the Kroll process entirely.

30–50%
Lower Energy
<600 ppm
Final Oxygen
~20–35/kg
Est. Cost
Key Innovations
  • Partitioned three-chamber semi-continuous reactor
  • V₂O₅ exotherm drives TiO₂ reduction
  • Hybrid PESR + Calcium Vapor deoxidation
  • Direct Ti-6Al-4V production (no separate alloying)
Read Full Research Paper ↗
Chemistry · Hydrogen Energy · 2026
Converting Flare Gas into Clean Hydrogen
SE-SMR with CaO — A Technical Investigation into Sorption-Enhanced Steam Methane Reforming for Flare Gas Recovery
Author: Sampatirao Trilok Varma (Trilok Varma) HOD, Research Chemistry Department NPMAI ECOSYSTEM · 2026

This paper presents a detailed technical investigation into Sorption-Enhanced Steam Methane Reforming (SE-SMR) with calcium oxide (CaO) as the integrated CO₂ sorbent — specifically designed for converting methane-rich flare gas into high-purity hydrogen while simultaneously capturing CO₂ at source.

96%
CH₄ Conversion
94.3%
H₂ Purity
>90%
CO₂ Capture
~20%
Energy Savings
Key Research Contributions
  • Optimised operating conditions for flare gas (650°C, S/C = 4–5, CaO/CH₄ ≈ 3)
  • Bifunctional NiO-CaO-Ca₁₂Al₁₄O₃₃ catalyst
  • Dual fluidized bed reactor design
  • Full thermodynamic, kinetic, and stoichiometric derivations
  • Geological storage vs CO₂-to-Methanol pathway comparison
Read Full Research Paper ↗
Chemistry · Energy · Synthetic Fuels · 2026
Ethanol Problem Solved
Tx Synthetic Petrol — Integrated Ethanol Upgrading with Biogas SE-SMR
Author: Sonu Kumar Founder, NPMAI ECOSYSTEM NPMAI ECOSYSTEM · 2026

This paper proposes an integrated route for converting ethanol into synthetic petrol-range hydrocarbons — combined with biogas SE-SMR upgrading — as a full chemical alternative to India's current raw ethanol blending policy, addressing the car-fuel compatibility gap directly.

Read Research Paper ↗

Mathematics research from the NPMAI ECOSYSTEM Research Mathematics Department. Click the paper to view the full research.

Mathematics · Network Theory · Game Theory · 2026
Achieving Social Optimality in Multi-Criterion Congestion Control
Dynamic Routing, Equity-Indexed Pricing, and Bifurcation Analysis in Heterogeneous Agent Networks
Author: Adarsh Singh HOD, Research Mathematics Department NPMAI ECOSYSTEM · 2026

This paper tackles one of the fundamental tensions in network theory: the gap between individually rational routing (Nash equilibrium) and socially optimal routing that minimises system-wide congestion. The research introduces a multi-criterion framework combining dynamic routing, equity-indexed congestion pricing, and bifurcation analysis to characterise when and how networks transition between stable and unstable regimes.

Core Frameworks
Nash Equilibrium · Wardrop Conditions · Equity-Indexed Pricing · Bifurcation Analysis
Problem Addressed
Bridging Price of Anarchy with heterogeneous agent preferences across multi-commodity networks
Key Innovation
Equity-indexed Pigouvian pricing mechanism that achieves social optimum without violating individual rationality
Research Areas Covered
  • Multi-criterion congestion control with heterogeneous agent preferences
  • Dynamic routing algorithms converging to socially optimal solutions
  • Equity-indexed pricing mechanisms preserving fairness while reducing Price of Anarchy
  • Bifurcation analysis — characterising phase transitions between stable and unstable network regimes
  • Formal proofs of convergence under generalised Wardrop conditions
  • Applications to transportation networks, internet traffic, and resource allocation
Read Full Research Paper ↗

Changelog

Release history for the npmai Python package.

The Founder

Sonu Kumar — Founder NPMAI ECOSYSTEM, Bihar Viral Boy

Sonu Kumar

Founder of NPMAI ECOSYSTEM · HOD Research Tech (CS, AI) & Social Science (Political Science, Legal) Departments · Bihar Viral Boy

Software Developer · AI Developer · Web Developer · Cloud Developer · DevOps · TEDx Speaker · Social Thinker · Researcher
Student at Allen Career Institute & Disha Delphi Public School, Kota (100% Scholarship, since 2022)

👤 Age 15 🇮🇳 Bihar, India 🏫 Kota, Rajasthan 440K+ followers TEDx Speaker
3.5M+
PyPI downloads
440K+
Social followers
TEDx
Speaker at 13
100%
Allen scholarship
45+
LLMs in ecosystem
4
Research papers 2026

The Journey — How Sonu Kumar Went Viral

Age 9 — The Teacher
Started Teaching Nursery Kids in Class 4th
While still in 4th grade himself, Sonu began teaching nursery-level children in his village. This early experience with education inequality planted the seed for his lifelong mission to improve learning access for underserved communities in India.
Age 11 — The Moment That Changed Everything
Met the Chief Minister — Raised Education & Liquor Ban Issues
At age 11, Sonu met the Chief Minister of Bihar and directly raised two critical issues: the poor quality of education in government schools, and the weak implementation of the liquor ban in Bihar. This act of civic courage by an 11-year-old went viral across India, earning him the name Bihar Viral Boy.
Age 11-12 — National Recognition
Offers from Across India — Politicians, Educators, and Actors
After going viral, Sonu received support and recognition from prominent figures across India:
Chirag Paswan — Minister of Food Processing (Cabinet, BJP) R.K. Sinha — Chairman SIS Group, Former Rajya Sabha MP (BJP) Late Sushil Kumar Modi — Former Deputy CM, Bihar (BJP) Pappu Yadav — MP Purnia, Bihar (Congress) Sonu Sood — Bollywood Actor & Philanthropist Yaduvanshi Siksha Niketan, Haryana — Former Haryana Congress MLA Brajesh Maheshwari — Founder & Former CEO ALLEN Career Institute
Age 13 — TEDx Speaker
Delivered a TEDx Talk on Education & Social Change
Sonu delivered a TEDx Talk, becoming one of India's youngest TEDx speakers. His talk addressed the systemic failures in rural education and his vision for using technology to bridge India's urban-rural learning divide.
Age 13-14 — The Builder
Founded NPMAI ECOSYSTEM — 2 Million+ Downloads
Self-taught without any CS background in the family, Sonu built the entire NPMAI ECOSYSTEM on free cloud infrastructure — Render, HuggingFace Spaces, Supabase, Netlify. The ecosystem now serves hundreds of thousands of developers worldwide.
2026 — Researcher
Published Four Research Papers — LARA, RID, IAST, Article 82B
Published four original research papers in 2026: LARA (novel RAG architecture), Representative Ideal Democracy (political science framework), Ideal Administrative System Theory (comparative governance), and Beyond the Remainder Term — a Constitutional Bridge Mechanism (Article 82B) proposing a legislative alternative to the One Nation One Election remainder term provision. All freely available under the NPMAI ECOSYSTEM research programme.

Mission

"Promoting Individual Journalism to every nation's village so that the democratic values of a nation can be strengthened and we can achieve Representative Ideal Democracy."

— Sonu Kumar, Founder, NPMAI ECOSYSTEM

Developer Hub

Resources for developers building on or contributing to the NPMAI ECOSYSTEM.

GitHub ↗ PyPI ↗ Contact ↗
🤝 Contribute to NPMAI ECOSYSTEM

NPMAI ECOSYSTEM is a community-driven platform. Here's how it scales to handle 80,000+ requests in 24 hours without paying for servers or charging anyone — through open contribution from developers worldwide.

NPMAI currently manages 80,000+ requests in 24 hours without paying for servers — actively scaling through community contributions.
1
Email Us Your Intent
Send an email to sonuramashishnpm@gmail.com explaining what you want to contribute — a new model, tool, code improvements, or documentation. Share which model you want to add and any relevant details.
2
Share Your Model Endpoint Links
Deploy your model on HuggingFace Spaces or any free hosting. Provide two URLs: a primary link and a fallback link for the same model. NPMAI adds both to the load balancer — your model joins the 45+ pool instantly.
3
Or Raise a PR / Issue on GitHub
Prefer GitHub? Raise a Pull Request or open an Issue at github.com/sonuramashishnpm. NPMAI will review and approve, request changes, or discuss integration. Ideas and discussions are welcome too.
4
Get Credited
All contributors are credited in the ecosystem. Your model, contribution, and GitHub profile are listed in the docs — reaching hundreds of thousands of developers who use the package daily.
What We Accept
New LLM endpoints · Bug fixes · Documentation improvements · New project integrations · Research contributions · UI improvements · Test cases · Translations

⚙ Load Balancer Architecture

The NPMAI load balancer distributes requests across all contributed model endpoints. When the primary is busy, requests fall to the fallback — ensuring 24/7 availability.

POST
https://npmaiecosystem-load_balancer.hf.space/load_balancer
Primary load balancer — routes to all 45+ model endpoints
POST
https://npmaiecosystem-loadbalancerfallback.hf.space/load_balancer
Fallback load balancer — same functionality, automatic failover

Research Team

The minds behind NPMAI ECOSYSTEM's multi-department research programme. Each department is led by a Head of Department driving original research in their domain.

Founder & HOD — Research Tech (CS, AI) & Social Science (Political Science, Legal)
Sonu Kumar
Sonu Kumar
Founder, NPMAI ECOSYSTEM · HOD Research Tech (CS, AI) & Social Science (Political Science, Legal) · Bihar Viral Boy
👤 Age 15 🇮🇳 Kota, Rajasthan TEDx Speaker 440K+ Followers Allen Career Institute 100% Scholarship

Sonu Kumar is a 15-year-old software developer, AI researcher, and TEDx speaker from Bihar, India — now studying at Allen Career Institute and Disha Delphi Public School, Kota on a 100% scholarship. He is the founder of NPMAI ECOSYSTEM, an open-source AI research and development community publicly known as the platform that makes frontier AI accessible to everyone for free, and goes by the name Bihar Viral Boy — a name he earned at age 11 after going viral across India for directly confronting the Bihar Chief Minister about education quality and the weak implementation of the liquor ban.

That moment turned into a life mission. Sonu has since become one of India's youngest TEDx speakers (at 13), built an ecosystem that has crossed 2.5 million downloads, published four original research papers — LARA (RAG architecture), Representative Ideal Democracy, Ideal Administrative System Theory, and Beyond the Remainder Term (Article 82B constitutional law) — and built a roster of production-grade tools including NPM Journalist, NPM Debater AI, NPM AutoCode AI, and NPM Legal AI. As HOD of the Research Tech (CS, AI) and Social Science (Political Science, Legal) departments, he connects cutting-edge AI engineering with original civic and constitutional thought.

His philanthropic impact extends to the people around him. When Brajesh Maheshwari (Co-Founder, ALLEN Career Institute) extended an offer of support to Sonu, that gesture of belief enabled him to study in Kota and continue building NPMAI ECOSYSTEM with the resources and environment he needed to grow — an act of trust he carries with him as both personal motivation and a model for what mentorship can unlock.

Key Milestones
Founder, NPMAI ECOSYSTEM — 3.5M+ PyPI downloads
TEDx Speaker at age 13 on Education & Social Change
Published 4 research papers — LARA, RID, IAST, Article 82B
440K+ social followers as Bihar Viral Boy
Met Bihar CM at age 11 — raised education & governance issues
100% Scholarship at Allen Career Institute, Kota (since 2022)
NPM AutoCode AI — desktop agent with 21 integrated tools
NPMSMA — multi-platform social media automation
Department of Physics
Dr. Brajesh Maheshwari (BM Sir)
Dr. Brajesh Maheshwari
HOD Research Physics Department · Co-Founder & Director, ALLEN Career Institute · BM Sir
🏛 Co-Founder, ALLEN Career Institute Gold Medal — NIT Surat Executive Director, ALLEN 1M+ YouTube Subscribers Philanthropist & Mentor

Dr. Brajesh Maheshwari — widely known among students as BM Sir — is one of the most influential educators in India and a driving force behind Kota's transformation into the coaching capital of the nation for engineering and medical entrance examinations. As Co-Founder and Executive Director of ALLEN Career Institute, he built — alongside his three brothers, Govind, Rajesh, and Naveen Maheshwari — an institution that has shaped the academic trajectories of millions of students.

A gold medallist in Civil Engineering from NIT Surat, BM Sir chose teaching over traditional engineering — and that choice created a legacy. He serves as Head of the Physics Department at ALLEN, actively teaching and structuring the physics curriculum for competitive examinations at the highest level. His motivational sessions, broadcast live to students across India, are not supplementary content — they are a lifeline for lakhs of young people battling examination pressure, self-doubt, and the weight of family expectations.

Beyond academics, BM Sir is a philanthropist whose belief in people has changed lives. When Sonu Kumar — a teenager from a village in Bihar who had gone viral for confronting the state Chief Minister about education — came to Kota, it was BM Sir's extended hand of support that enabled Sonu to study at Allen Career Institute and build NPMAI ECOSYSTEM. By adopting Sonu Kumar's education and giving him the environment to flourish, BM Sir became not just a mentor but proof of his own mission: that the right person, at the right moment, can alter the entire trajectory of a young life.

Contributions & Recognition
Co-Founded ALLEN Career Institute — transformed Kota into India's coaching capital
Gold Medal in Civil Engineering, NIT Surat
HOD Physics at ALLEN — active curriculum design & teaching
1M+ subscribers on Brajesh Maheshwari YouTube channel
Mega motivational sessions reaching millions of students
Philanthropist — adopted Sonu Kumar's education (Founder, NPMAI ECOSYSTEM)
Recognised as one of India's leading education entrepreneurs
Department of Mathematics
Aadarsh Singh
Aadarsh Singh
HOD Research Mathematics Department
👤 Age 15 INMO Qualified 2026 Purple Comet World Rank 1 AMC Perfect Score

The relationship between Aadarsh Singh and mathematics did not begin with a textbook — it began with a question. At nine years old, what drew him in was not the calculations or the formulas, but the logic underneath them. Mathematics felt different from every other subject: every statement had a reason, every conclusion had a chain of thought behind it, and every problem was a mystery waiting to be unravelled. That feeling never left him.

His father nurtured that curiosity during childhood, and his mother provided the unwavering support that allowed it to grow from school interest to serious discipline. In eighth grade, Aadarsh was introduced to mathematical olympiads. In his very first year, he qualified for INMO — an achievement that told him this was a world he wanted to pursue seriously. Then came INMO, and a harsh reality check: zero marks. He saw exactly how vast the world of higher mathematics truly was.

The year after was, if anything, harder. He missed the IMOTC qualification cutoff by five marks. Unlike the first failure — where he had been simply outclassed — this time he knew he had been close. It was heartbreaking. He returned to training with greater discipline, working through algebra, combinatorics, and number theory. That perseverance paid off in his third attempt: INMO qualified, and a place at IMOTC earned. Progress in mathematics, he has said, is rarely linear. Success often comes after repeated failures — provided you continue to learn from them.

For Aadarsh, mathematics is more than a collection of problems and theorems. It is a way of thinking — feeling like a detective, finding patterns, watching unrelated observations fit into a complete solution. That is what keeps drawing him back. His immediate goal is clear: to represent India at the International Mathematical Olympiad.

Achievements
INMO Qualified (2026)
Qualified for INMO (2024, 2025, 2026)
NSEJS State Top 10 · NSEA State Top 8
AMC Perfect Score · AIME Qualifier
One of India's best IOQM 2025 scores (79/100)
Purple Comet World Rank 1 · Math Premier League World Rank 1
Selected among India's top 100 mathematics & finance minds at Math.Biz(2024, 2025)
NMTC Junior Qualifier (2024, 2025)
FTRE AIR-19 · FIITJEE-IITGENIUS AIR-2 · TALLENTEX AIR-16 · DSSL AIR-3 · TSTMS State Rank 1
Co-founded telegram channel for math olympiad guidance
Ex-administrator of one of India's biggest math olympiad channels
🎴 Hobbies: Cards (games & tricks), fiction novels, cricket, chess, thriller movies
Department of Chemistry
Sampatirao Trilok Varma
Sampatirao Trilok Varma
HOD Research Chemistry Department · Aspiring Chemist · Chemical Dynamics & Biomedical Engineering Researcher
👤 Age 15 DOB: 15 Dec 2010 Chemical Dynamics Biomedical Therapeutics Materials Science

Trilok Varma's journey into chemistry began with a moment in 7th grade that most students would regard as a routine lab demonstration: an acid-base neutralisation reaction. While others watched the expected colour change, Trilok was asking a different set of questions — why does the reorganisation happen at the atomic level, and what would change if the variables were altered? When the classroom ran out of answers, he went looking for them in academic papers, advanced textbooks, and digital resources. That self-directed curiosity is still the engine driving his research.

Now 15, Trilok is building the theoretical foundation needed to engage with two of the most consequential challenges in science: targeted therapy for complex diseases, and the design of novel high-performance materials. His research interests sit at the intersection of advanced physical chemistry, organic chemistry, biochemistry, and materials science — disciplines that, in his view, are most powerful when they talk to each other.

In biomedical research, Trilok is focused on designing synthetic proteins that can halt cancer cell migration, developing molecular traps for precise drug delivery, investigating the biophysics of prion unfolding and misfolding, and studying the kinetics of metallic toxins in biological systems alongside targeted chelating agents. In physical chemistry, he is working on deterministic kinetic analysis of variable-order reactions and exploring how specific molecular vibrational states influence transition state thermodynamics. In materials science, his interest lies in the synthesis of novel lightweight materials engineered for extreme tensile strength — structures that perform where conventional materials fail.

Macromolecular Therapeutics Metastasis Inhibition Molecular Traps & Drug Delivery Prion Dynamics Toxicology & Chelation Deterministic Kinetic Analysis Vibrational Thermodynamics High-Tensile Materials Synthesis SE-SMR Hydrogen Research
"The transition from asking simple questions about a neutralisation reaction to mapping the complex kinetics of molecular systems defines my path. I aim to use chemistry not just to understand the physical world, but to engineer solutions for its most pressing medical and structural challenges." — Trilok Varma