nano SIEM
Hunts

Run hunts

Supported in:Self-hosted

Run hunts on the nano server or in nano Desktop, run them now or on a schedule, limit each run with budgets, and stop them.

Run a hunt now or on a schedule. Choose where its AI runs: on the nano server with the AI provider you configured, or in nano Desktop on an analyst's computer. Either way, the hunt reads the same data and its findings appear in the same place.

Before you begin

Choose a runner

A runner is what runs a hunt's AI steps. There are two kinds.

Server runnerDesktop runner
Where the AI runsOn the nano serverOn an analyst's computer, in nano Desktop
Which AIThe models assigned to the hunt agents in Agent ModelsThe analyst's own coding agent and model
Queries and scoringOn the server, without AIOn the server, without AI
ReviewerOn the serverOn the server, if you turn it on for the hunt
FindingsIn nanoIn nano

Each run records which runner and which AI model produced it.

The server runner is built in and on by default. It reads your data through a private, read-only connection that only it can use. It doesn't need the Agent Lane switch or listener that external agents use. See Hunt security.

The Desktop runner runs in nano Desktop. Use it when you want an analyst's own AI agent to investigate, or when you don't want the server to call an AI provider.

The Runners page

Check the runners

  1. Click Hunts, then Runners.
  2. Check that the server runner shows online. If it shows unavailable, the reason is listed. See The server runner is unavailable.

Choose where a hunt runs

Each hunt runs on server, desktop, or any. New hunts run on server when a working server runner is online, and on desktop otherwise. Hunts created before v2.0.32 keep desktop.

To change it, call the API with runner_kind. You need hunts:manage.

curl -X PATCH "https://<your-nano-host>/api/hunts/<hunt-id>" \
  -H "X-API-Key: $NANO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"runner_kind": "server"}'

The change applies to the next run. A run that already started finishes where it is.

Run a hunt now

  1. Click Hunts and open the hunt.
  2. Click Run now.

nano queues a run over the hunt's time window, which is the last 24 hours by default, and opens it. A hunt runs one sweep at a time.

When the run ends, it shows one of these outcomes:

OutcomeMeaning
completedThe run finished. nano shows how many findings it filed.
no_leadsThe run finished without findings.
no_coverageNone of the hunt's sources had data. No AI was used.
budget_exhaustedA budget ran out. The findings filed so far are kept.
heldA source the hunt needs is unhealthy.
errorThe run failed, or its runner stopped responding.
cancelledThe run was stopped, for example because the hunt was archived.

Schedule a hunt

  1. Open the hunt.
  2. In Schedule, choose Daily 03:00, Daily 05:00, Every 6h, Every 12h, or Weekly Mon 04:00.
  3. Click Enable.

New hunts start disabled, including hunts from templates and imported hunts. A person decides when they run.

When several hunts are due, nano runs the most important first. Priority grows with the hunt's risk weight, how overdue it is, and how many active campaigns it tracks. Every due hunt still runs, so no hunt waits forever.

If nano was down and missed runs, it doesn't queue each missed run. It runs once, over a window that covers the gap, up to 72 hours by default.

Set budgets

Every run has budgets. The hunt page shows its budgets, and each run shows how much it used.

BudgetLimitsDefault for new hunts
budget_max_ai_tokensBudget tokens the investigator uses500,000
budget_max_tool_callsInvestigator queries and actions60
budget_max_turnsInvestigator AI turns40
budget_max_wall_secondsTotal run time, in seconds900 (15 minutes)
budget_max_rowsRows the investigator reads20,000
ReviewerBudget tokens for each finding, and for all findings in one run100,000 for each finding, at most 1,000,000 for each run

Cached input counts as about a fifth of a token toward a budget. Billing isn't affected.

nano always keeps room for a final turn, so a run can file what it found before it stops. When a budget runs out, the run ends as budget_exhausted and keeps its findings.

To change a budget, call the API. You need hunts:manage.

curl -X PATCH "https://<your-nano-host>/api/hunts/<hunt-id>" \
  -H "X-API-Key: $NANO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"budget_max_ai_tokens": 250000}'

See Cost and budgets.

Stop hunts

You can't stop a single run from the page. Use one of these options:

ToDo this
Stop a hunt's future runsClick Disable on the hunt, or set Schedule to manual only. A run in progress finishes.
Stop a hunt now, including a run in progressArchive the hunt with DELETE /api/hunts/<hunt-id>. You need hunts:manage. Its runs end as cancelled.
Stop all scheduled runsSet HUNT_SCHEDULER_ENABLED=false on the jobs service. Hunts then run only when someone clicks Run now.
Stop the server runnerSet NANO_HUNTS_SERVER_RUNNER=off on the jobs service. Runs in progress save what they have and end as cancelled.

If a runner stops responding during a run, nano ends the run as error after a timeout. The next run can then start.

What's next

On this page