NeuroAgent AI
One framework. Infinite agents. Build production-ready AI agents, multi-agent teams, RAG systems, database & API agents, and autonomous workflows from one provider-agnostic Python package.
mypy --strictpip install neuroagent-ai
from neuroagent import Agent
agent = Agent(provider="anthropic", model="claude-opus-4-8")
print(agent.run("Analyze our Q3 sales data and write a short summary."))
| You get | Instead of |
|---|---|
Agent class | Gluing 5+ vendor SDKs together |
provider="openai" | "anthropic" | "gemini" | "groq" | Vendor lock-in |
memory="sqlite", rag=True, tools=[...] | Custom infra per project |
Workflow, Team, DatabaseAgent, APIAgent | Reinventing orchestration |
agent.stats(), traces, agent.serve() | Bolt-on observability & servers |
| Capability | NeuroAgent AI | Raw vendor SDKs | Typical agent framework |
|---|---|---|---|
| Provider-agnostic core | Built in | β one vendor | Partial, often leaky |
| Tool calling | Auto-schema from signature | Hand-written JSON schema | Usually auto-schema |
| Memory backends | Session/SQLite/Redis/Vector | DIY | Varies, often one backend |
| RAG | Built in (rag=True) | DIY (load/chunk/embed/store) | Usually a separate library |
| Database agents (NLβSQL) | Built in, read-only by default | DIY | Rare, or third-party |
| Multi-agent teams | Pipeline/router/debate/hierarchical | DIY | Common, but a parallel system |
| Workflow DAGs | Parallel steps, retries, resume | DIY | Sometimes |
| Observability & cost | Automatic spans + tokenβ$ cost | DIY | Often bolt-on or missing |
| Enterprise security | RBAC, audit log, secrets, sandbox | DIY | Rare |
| HTTP deployment | agent.serve(), one line | DIY FastAPI app | Rare, or heavy |
| Base install footprint | No vendor SDKs, extras opt-in | One SDK | Often pulls in many deps |
One typed, async-first Agent with auto-schema tool calling. Learn more β
Session, SQLite, Redis, and semantic vector recall. Learn more β
Load PDFs/DOCX/text and chat grounded in your documents. Learn more β
Natural language β SQL or any HTTP API, read-only by default. Learn more β
DAG orchestration with parallelism, retries, and checkpoint resume. Learn more β
Pipeline, router, debate, and hierarchical collaboration patterns. Learn more β
Every run traced and costed automatically β no setup. Learn more β
RBAC, audit logs, secret masking, and sandboxed tool execution. Learn more β
agent.serve() turns any agent into an HTTP service. Learn more β
Real coverage, lint, and type-check numbers β not marketing claims. Learn more β
No. Agent talks to OpenAI, Anthropic, Gemini, and Groq through one
LLMProvider contract β switch with a string (provider="anthropic") and no
other code changes. You can also register a custom provider for any OpenAI-compatible endpoint.
No. The built-in echo provider runs fully offline (no network, no key) so you can
explore the entire API β tools, memory, workflows β before spending a cent. See
Getting Started.
Four dependencies: pydantic, pydantic-settings, httpx,
structlog. No vendor LLM SDKs β OpenAI/Anthropic/Gemini/Groq are implemented directly
over httpx. Everything else (RAG loaders, SQL, Redis, encryption, the HTTP server) is
an opt-in extra. See Quality & Benchmarks.
DatabaseAgent and APIAgent are read-only by default β
writes require an explicit opt-in. Pair them with RBAC and AuditLog from
the Enterprise Security primitives for production deployments.
Yes β ghcr.io/theamitchandra/neuroagent-ai is published on every release. See
HTTP Server for the run command.