Skip to content

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.

Select a tool, fit it into an answer, and inspect the result.

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:

Check the current weather in Tokyo, including the temperature and conditions.

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:

Use Python to calculate the sum and average of 12, 18, 25, and 9.

Once it returns 64 and 16, follow up with:

Use Python to make a bar chart of those four values and save it as a PNG I can download.

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:

Compare the heat pump subsidies in Germany, France, and the Netherlands for 2026.

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.