Skip to content

Guides

Implementation-focused guides for common production patterns.

Core guides

  • Strategy — Gearbox strategy and mode selection
  • Agent guide — Agent lifecycle and configuration
  • Agent config guide — AgentConfig deep dive
  • MCP integration — Model Context Protocol universal adapter — 🟢 nucleusiq-mcp 0.1.0 Stable, nucleusiq>=0.7.12 + legacy OpenAI server-side path
  • File handling — Attachment vs Tool vs Both

Provider guides

Provider Package Version Status
OpenAI nucleusiq-openai 0.7.0 🟢 Stable — Chat Completions, Responses API, native tools (web_search / code_interpreter / file_search), native-tool observability
Gemini nucleusiq-gemini 0.3.0 🟢 Stable — google_search / code_execution server-tool observability, thinking, multimodal
Anthropic nucleusiq-anthropic 0.2.0 🟢 Stable — Phase B feature-complete (native tools, prompt caching, extended thinking)
Groq nucleusiq-groq 0.1.0 🟢 Stable — Chat Completions, local tools, streaming, server-tool emission stub
Ollama nucleusiq-ollama 0.2.0 🟢 Stable — chat, streaming, tools, structured output, vision

All providers require nucleusiq>=0.7.12.

Cross-cutting concepts (new in v0.7.12)

Pair with the Anthropic provider guide

These three pages explain features that are exposed through nucleusiq-anthropic 0.2.0 but the observability they surface (executed_by="provider", cache_*_tokens, stop_reason, request_id) applies uniformly across every provider in v0.7.12.

  • Native server tools — web_search / code_execution / google_search / file_search — local vs provider execution.
  • Prompt caching — Anthropic cache_system / cache_tools and reading cache_read_input_tokens.
  • Extended thinking — Claude thinking="low"|"medium"|"high"|"max" and its hard constraints.