Metadata-Version: 2.4
Name: nucleusiq-ollama
Version: 0.1.0a1
Summary: Ollama inference provider for the NucleusIQ AI agent framework (official ollama Python SDK).
Project-URL: Homepage, https://github.com/nucleusbox/NucleusIQ
Project-URL: Repository, https://github.com/nucleusbox/NucleusIQ
Project-URL: Issues, https://github.com/nucleusbox/NucleusIQ/issues
Author-email: Nucleusbox <info@nucleusbox.com>
License: MIT
Keywords: AI,agents,local-llm,nucleusiq,ollama
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
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: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: <4.0,>=3.10
Requires-Dist: nucleusiq>=0.7.10
Requires-Dist: ollama<1.0,>=0.5.0
Description-Content-Type: text/markdown

# nucleusiq-ollama

Alpha provider for running **NucleusIQ** agents against [Ollama](https://docs.ollama.com/) (local or hosted).

## Install

```bash
pip install nucleusiq-ollama
```

Requires a running Ollama server unless you point `OLLAMA_HOST` at a remote instance. Optional: `OLLAMA_API_KEY` for authenticated endpoints.

## Usage

```python
from nucleusiq_ollama import BaseOllama, OllamaLLMParams

llm = BaseOllama(model_name="llama3.2", llm_params=OllamaLLMParams(think=True))
```

Runnable scripts (smoke, Agent DIRECT, streaming) live under **`examples/`** — see [`examples/README.md`](examples/README.md).

See [OLLAMA_PROVIDER.md](https://github.com/nucleusbox/NucleusIQ/blob/main/docs/design/OLLAMA_PROVIDER.md) for capability matrix, environment variables, and roadmap.

## Status

**0.1.0a1** — chat, streaming, tools, structured outputs (JSON schema / `format`), and `think` pass-through. Vision, embeddings, and web search are planned follow-ups.
