Metadata-Version: 2.4
Name: nucleusiq
Version: 0.7.14
Summary: NucleusIQ – open-source framework for building autonomous AI agents with advanced prompt engineering, flexible execution modes, and modular architecture.
Author-email: Nucleusbox <info@nucleusbox.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/nucleusbox/NucleusIQ
Project-URL: Documentation, https://github.com/nucleusbox/NucleusIQ#readme
Project-URL: Repository, https://github.com/nucleusbox/NucleusIQ
Project-URL: Issues, https://github.com/nucleusbox/NucleusIQ/issues
Project-URL: Changelog, https://github.com/nucleusbox/NucleusIQ/releases
Keywords: AI,agents,orchestration,framework,prompt-engineering,LLM
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Operating System :: OS Independent
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: <4.0,>=3.10
Description-Content-Type: text/markdown
Requires-Dist: pydantic<3.0,>=2.11.0
Requires-Dist: PyYAML<7.0,>=5.4
Requires-Dist: python-dotenv<2.0,>=0.19.0
Requires-Dist: typing_extensions>=4.0; python_version < "3.11"
Requires-Dist: ddgs<10,>=9.0
Provides-Extra: openai
Requires-Dist: nucleusiq-openai; extra == "openai"
Provides-Extra: mcp
Requires-Dist: nucleusiq-mcp>=0.1.0; extra == "mcp"
Provides-Extra: clustering
Requires-Dist: scikit-learn>=1.0; extra == "clustering"
Provides-Extra: http
Requires-Dist: requests<3.0,>=2.33.0; extra == "http"
Requires-Dist: urllib3>=2.7.0; extra == "http"

# NucleusIQ

[![PyPI version](https://img.shields.io/pypi/v/nucleusiq?color=brightgreen)](https://pypi.org/project/nucleusiq/)
[![PyPI downloads](https://img.shields.io/pypi/dm/nucleusiq?label=downloads%2Fmonth)](https://pypistats.org/packages/nucleusiq)
[![Python versions](https://img.shields.io/pypi/pyversions/nucleusiq)](https://pypi.org/project/nucleusiq/)

**Core package** for the NucleusIQ AI agent framework.

Includes agents, prompts, tools, memory, plugins, execution modes, and tracing.

Install a provider separately: `nucleusiq-openai`, `nucleusiq-gemini`, `nucleusiq-anthropic`, `nucleusiq-groq`, `nucleusiq-ollama`, `nucleusiq-openai-compatible` (vLLM / SGLang / TGI / llama.cpp / any Chat Completions server), or `nucleusiq-mcp`.

See the main [README](https://github.com/nucleusbox/NucleusIQ) for full documentation.

## Install

```bash
pip install nucleusiq
pip install nucleusiq-openai                    # OpenAI cloud
pip install nucleusiq-openai-compatible         # self-hosted / OpenAI-compatible
```

## Quick Start

```python
from nucleusiq.agents import Agent
from nucleusiq.llms import MockLLM

agent = Agent(name="test", role="assistant", objective="help", llm=MockLLM())
result = await agent.execute({"id": "1", "objective": "Hello!"})
```
