NucleusIQ Documentation
Build AI agents as durable software systems, not one-off demos.
What We Are Building
NucleusIQ is an open-source, agent-first Python framework for teams that want to ship agents into real products.
The core idea is simple: agents should be engineered like serious software systems:
- maintainable by teams over time
- testable and observable in production
- provider-portable as the ecosystem changes
- structured for tools, memory, policy, and validation
An agent is not just one model call. It is a managed runtime with responsibilities.
Why NucleusIQ Exists
Modern models can produce impressive demos quickly.
The hard part is owning those systems for months and years.
NucleusIQ is designed to close that gap between:
- what AI can generate fast, and
- what engineering teams can safely maintain long term.
This means less fragile glue code, less accidental complexity, and clearer architecture as systems grow.
Our Philosophy
NucleusIQ follows a practical philosophy for dependable agent engineering:
1) Agent-first thinking
Design around the full agent lifecycle (execution, tools, memory, policy), not isolated model calls.
2) Harness over hype
Reliability comes from good scaffolding: boundaries, artifacts, visibility, and feedback loops.
3) Progressive complexity
Start simple, add orchestration only when the task justifies it.
4) Open integration, closed coupling
Integrate broadly with providers and tools, but keep the core architecture stable and portable.
5) Reliability is a feature
Validation, structured output, policy controls, and observability are first-class parts of the framework.
Build Path
Choose your path based on where you are today:
- Start: Installation and Quickstart
- Understand: Overview and Core Concepts
- Scale: Execution Modes, Tools, Memory, Plugins
- Ship: Production Architecture, Structured Output, Observability