Starter path

A step-by-step learning sequence for new NucleusIQ users.

1. Install and run

• Install NucleusIQ — Core + provider package (OpenAI, Gemini, Groq, Ollama, etc.)
• Quickstart — Run your first agent in minutes (includes Groq + Ollama sections)

2. Add tools

• Tools overview — Three ways to create tools
• @tool decorator — Create tools from plain functions (fastest path)
• Built-in file tools — FileRead, FileSearch, FileWrite, and more

3. Choose an execution mode

• Execution modes — Direct, Standard, Autonomous
• Start with STANDARD (the default) — add tools and let the agent iterate

4. Add memory

• Memory — 5 strategies for conversation history
• Start with SLIDING_WINDOW for chat applications

5. Track usage and costs

• Usage tracking — Token counts by purpose and origin
• Cost estimation — Dollar costs with built-in pricing

6. Try more backends

• Provider portability — Same agent code, different LLM
• Gemini quickstart example — All three modes with Gemini
• Groq quickstart — Cloud inference (beta)
• Ollama quickstart — Local /api/chat (alpha)

Next steps

Move on to the Production path when you are ready to ship.