Skip to content

Examples

Detailed practical examples for common NucleusIQ workflows.

Updated for v0.7.10+: mandatory prompt= and current pins; Anthropic Claude (alpha) examples live under Anthropic quickstart. See migration notes if upgrading.

Getting started

  • Basic agent — Your first agent with tools (OpenAI, Gemini, context management)
  • Streaming — Real-time token-by-token output

Workflows

Observability

Provider examples

  • Gemini quickstart — Google Gemini with all three execution modes
  • Anthropic quickstart — Claude DIRECT / STANDARD / AUTONOMOUS (nucleusiq-anthropic 0.1.0a1, nucleusiq>=0.7.10 — alpha)
  • Groq quickstart — Groq DIRECT / STANDARD / AUTONOMOUS (nucleusiq-groq 0.1.0b1, nucleusiq>=0.7.9)
  • Ollama quickstart — Local Ollama DIRECT / STANDARD (nucleusiq-ollama 0.1.0a1, nucleusiq>=0.7.10 — alpha)
  • Anthropic provider guide — Alpha announcement, Messages API scope, structured-output caveats, runnable src/providers/llms/anthropic/examples
  • Groq provider guide — Beta scope, 429 / Retry-After, strict_model_capabilities, repo scripts
  • Ollama provider guide — Alpha scope, think, structured-output + tools caveat, repo matrix

Tool adapter examples

  • MCP quickstart — Universal Model Context Protocol adapter across every provider (nucleusiq-mcp 0.1.0b1, nucleusiq>=0.7.11 — beta): single stdio server, HTTP + Bearer auth, multi-server, filter/rename, graceful degradation, source tracing, plugin guardrails
  • MCP integration guide — Beta announcement, transports (stdio + Streamable HTTP + SSE), auth strategies (Bearer / OAuth 2.1 / Env / Custom), filtering, ping(), comparison vs OpenAI server-side MCP

Which page for Anthropic (Claude)?

Start with Anthropic quickstart; use Anthropic provider for install pins, env vars, limitations, and CI-tested examples.

Which page for Ollama?

Start with Ollama quickstart; use Ollama provider for the full capability matrix and env reference.

Which Groq page?

Start with Groq quickstart for copy-paste snippets; use Groq provider for deeper operational guidance.

Which page for MCP?

Start with MCP quickstart for copy-paste recipes (stdio + HTTP, multi-server, tracing); use MCP integration guide for the full beta scope, OAuth, decorator filters, and graceful degradation.

Repository examples

Full runnable scripts are available in the GitHub repository:

  • Core examples
  • OpenAI examples
  • Gemini examples
  • Anthropic examples — DIRECT through AUTONOMOUS, streaming, native structured demo (alpha)
  • Groq examples — Direct through Autonomous + structured output
  • Ollama examples — Smoke, Direct, streaming live, capabilities matrix (alpha)
  • MCP examples — Eight runnable examples: stdio, HTTP + auth, multi-server, OAuth, error handling, health check, decorator filters, full agent with LLM (beta)
  • Notebooks — Jupyter notebooks: context management showcase, mcp_tools_showcase.ipynb (Windows-friendly Streamable HTTP demo), and more