Working with Tools¶
Tools let Numi look up live information, run Python code and data analysis, read attachments, and generate downloadable files or images. Start from a working chat as shown in Your First Chat.
Enable and test a weather lookup¶
Core tools are always active, while specialized integrations (such as Weather, Scientific Research, Grocery, Recipes, and Shopping) belong to optional tool groups that stay off until needed.
Send this request:
If the Weather group is not enabled yet in this chat, Numi either offers a quick pre-turn activation card or requests activation so you can turn it on with one click (you can also toggle optional groups anytime from Open custom tools next to the message input).
Watch the tool call block in the reply as weather_fetch runs and returns live
forecast data. You can expand any tool block to inspect the exact parameters and
returned JSON.
While a tool is preparing or running, its expanded card shows a loading placeholder. The result replaces it in the same card. Search results use compact source rows; fetched pages also show content type, size, or a fetch error.
Run Python code and generate a chart¶
When code_interpreter is enabled, ask Numi to compute values or build a chart:
Once it returns 64 and 16, follow up with:
Generated charts, spreadsheets, PDFs, and documents appear right in the message stream with inline previews and download buttons.
Each code_interpreter call starts a fresh sandboxed Python environment: it can
read files uploaded to or created in the current chat, while in-memory Python
variables do not carry over between separate calls. When the model needs to call
several read-only tools in a loop and filter their results in one go, it can
also use codemode to script them together in a single sandbox run.
Inspect available tools¶
Open your profile menu at the bottom of the sidebar and select Tools to open the Available Tools dialog. It shows every tool registered on your instance along with its description and group.
Search the web and read pages¶
When web search is configured by the operator, try:
Search the web for the official documentation for Python's csv module and explain how to read a CSV file.
Numi runs web_search, cites its sources inline ([web:1]), and lists
clickable source chips below the answer. If you paste a specific URL into the
chat, Numi can also fetch and read that page directly with fetch_web_page.
Run Deep Research¶
For broad questions that require synthesizing many sources, click Deep research (the telescope icon next to the message input) before sending your prompt:
In Deep Research mode, the lead model first runs an initial survey search, then
spawns parallel background sub-agents (research_spawn) that investigate
different angles of your question at the same time. A live Research Board at
the top of the reply tracks each sub-agent's searches and page reads; click any
agent row to inspect its assignment and findings. Once all waves finish
(research_poll), the lead model writes a unified, cited report.
Deep Research stays toggled on in the composer until you switch it off.
Tool requirements for operators¶
All tools below are included in the default TOOLS_ALLOWLIST (TOOLS_DENYLIST
always takes precedence):
| Tool | Requirement |
|---|---|
code_interpreter, codemode |
Built-in Monty runner for simple pure-Python scripts; Deno for Pyodide package-based execution (numpy, pandas, matplotlib, office files, etc.) |
web_search |
At least one search key: KEENABLE_API_KEY, OCTEN_API_KEY, PARALLEL_API_KEY, EXA_API_KEY, YOU_API_KEY, or DEEPSEEK_API_KEY |
fetch_web_page |
A configured web provider key, or DIRECT_WEB_FETCH_ENABLED=true for direct HTTP fetching |
generate_image |
OPENROUTER_API_KEY |
numi_docs |
Bundled manual; no network access or API key required |
view, create_file, remember_fact, forget_fact, recall_memory, past_chats |
No external API key required |
read_skill |
SKILLS_ENABLED=true and at least one active skill |
weather_fetch |
Network access to the weather API (no API key required; part of the optional Weather group) |
See Tool settings for server configuration and Adding a custom tool to build your own tool.