> For the complete documentation index, see [llms.txt](https://docs.hivel.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hivel.ai/hybrid-hivel-agent/2.-getting-started/system-requirements.md).

# System requirements

### Minimum VM specs

These are the minimum host requirements for running hivel-agent itself. If you're also running the Claude OTel Collector for Claude Code usage tracking, see [Claude OTel Settings](/hybrid-hivel-agent/5.-configuration-reference/claudeotel-settings-claudeotel.md) for its separate host and port requirements.

| **Resource** | **Minimum**               | **Notes**                                                                                                                                                                                                                       |
| ------------ | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| CPU          | 2 cores                   | minimum 2 cores are required.Scale up beyond 2 cores for large organizations.                                                                                                                                                   |
| RAM          | 4 GB                      | 8 GB+ for large orgs - many repos, high issue/PR volume, or higher concurrent\_threads settings.                                                                                                                                |
| Disk         | 50 GB                     | Regular sync/download itself only needs headroom for compressed JSON snapshots (small). If you also run work-metrics against Bitbucket or Azure DevOps, budget more - see below                                                 |
| Network      | Outbound HTTPS (443) only | To your configured tool(s) and api.hivel.ai / S3, Inbound 4317 additionally required if the Claude OTel Collector is enabled- see [Network calls](/hybrid-hivel-agent/2.-getting-started/network-calls-inbound-and-outbound.md) |
| OS           | Linux, macOS, or Windows  | See Supported platforms                                                                                                                                                                                                         |

*These are practical starting points, not load-tested numbers for every deployment size. Scale up if you're syncing a very large instance (100k+ issues, 500+ repos) or see the agent running low on memory or disk.*<br>

### Extra disk if you run work-metrics (Bitbucket / Azure DevOps only)

GitHub and GitLab commit classification runs entirely over their blame REST APIs - no local disk impact either way. Bitbucket Cloud and Azure DevOps have no blame or PR-diff API, so [work-metrics](/hybrid-hivel-agent/8.-work-metrics-credentials-and-controls.md) clones each repo locally into clone\_cache\_dir (default /var/hivel/repo\_cache) to compute it. Size disk for this accordingly:

* Bitbucket / Azure DevOps needs **local git cli** installed.
* Clones are shallow by default (clone\_depth: 30 or clone\_since\_days: 30, not a full mirror), but total footprint still scales with **number of repos × their size**, since each repo classified gets its own cached clone.
* If you only use Bitbucket/Azure DevOps for regular sync and never run work-metrics, none of this applies - clone\_cache\_dir is only ever touched by the work-metrics command.
* For a large number of sizeable repos, plan disk well above the 50 GB baseline, or lower clone\_depth/clone\_since\_days to trade classification lookback window for disk.

{% columns %}
{% column %} <a href="/hybrid-hivel-agent/2.-getting-started/network-calls-inbound-and-outbound.md" class="button primary" data-icon="backward">Network calls</a>
{% endcolumn %}

{% column %}

{% endcolumn %}

{% column %} <a href="/hybrid-hivel-agent/3.-prerequisites-and-set-up.md" class="button primary" data-icon="forward">Prerequisites and Set-up</a>
{% endcolumn %}
{% endcolumns %}