> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ainomos.ch/llms.txt
> Use this file to discover all available pages before exploring further.

# Usage and budgets

> See what your rooms use and spend, how room budgets stop spending, and how to ask for more budget.

The **Usage** page shows what is happening in the rooms you can reach: how often people and apps ask, what it costs, how answers are backed, and how knowledge develops. Budgets set how much a room may spend on models each month. When a budget runs out, the room's owner asks for more and a platform admin decides.

## Open the Usage page

In the navigation, select **Usage**. The page opens on the room you are in and covers that room and the rooms below it. To see everything you can reach, pick **All rooms** in the room picker.

Who can do this: everyone with access to at least one room. You only see figures for rooms you can reach.

Two controls change the time window of most figures:

| Control | Options |
| - | - |
| **Period** | **7 days**, **30 days**, **90 days**, **12 months**, **All time**, or **Custom** with **From** and **To** dates. |
| **Bin size** | **Day**, **Week** or **Month**: how the trend charts group the days. |

Select **Show values** on a figure to read its numbers as a table.

## What the page shows

The top row shows **Consultations** for the period, with a trend line and the change against the previous period of the same length. Beside it are the counts of **open high-severity findings** and **stale or ownerless entries**, which link to the screens where you resolve them.

The sections below group the figures:

| Section | Figures |
| - | - |
| **Usage & cost** | **Consultations per day**. **Busiest rooms**, counted over all time. **Spend by room**: the recorded model cost per room in USD. **Calls by room**: model calls per room in the current month. |
| **Governance & risk** | **Answers by evidence status**, **Most frequent block reasons**, **Decisions by status**, **Findings by status** and **Rooms needing attention**. |
| **People & agents** | **Agent classes**: consultations per kind of connected app. **Most active person**. **My connections**: the apps you connected yourself. Platform admins also see **Most active people**, read from the audit log. |
| **Knowledge & learning** | **Relations by kind and origin**, **Share without effect** and **Proposals by outcome** from dreaming. |

> [!NOTE]
>
> **Spend by room** shows the total cost recorded so far. It does not follow the **Period** control. If some rooms could not be read, the figure says how many rooms its sum covers.

## How room budgets work

A room can have a monthly budget in USD.

* The budget counts model costs in the room: chat answers, questions from connected apps, and the small translation call that searches each question in the other language.
* A budget can be a hard stop. Then nothing more is sent to a model once the month's budget is spent.
* A room without a budget of its own is paid by a parent room, and the limit of the room that pays applies.
* On your own installation, the setup wizard can set a monthly cap for the top room. Every room below inherits it.

To see a room's budget, open the chat in that room, select **Context**, and look under **What restricts this task**. The panel shows how much of the budget is used this month, a meter, and whether a hard stop is set. If a parent room pays, it says so and names that room.

## When the budget is reached

When a room's budget is spent and a hard stop is set:

* A question in the chat gets no answer. Instead the chat shows a **Budget exhausted** card that names the room owner.
* Questions from connected apps in that room are refused the same way.
* The **Context** panel says that the budget is spent for this month.

The one-time starter credit on Ainomos cloud is a separate limit for the platform's models. See [The starter credit](https://docs.ainomos.ch/models/overview.md#the-starter-credit).

## Ask for more budget

A room owner asks for a higher monthly budget with a reason. The person the limit applies to cannot raise it alone: a platform admin decides.

Who can do this: room owners, in rooms that have a budget of their own.

**1. Open the room's context**

In the chat, open the room and select **Context**.

**2. Fill in the request**

Under the budget, enter the **Requested monthly budget (USD)**, or pick one of the quick picks from 25 to 10000 USD. Write a **Reason**: what the budget is needed for. Both are required.

**3. Send it**

Select **Request a raise**. The panel now shows the open request, with the amount and who filed it, to everyone in the room.

A room can have only one open request at a time. If someone else already asked, Ainomos says so and shows their request.

## Decide a budget request

Who can do this: platform admins.

Budget requests arrive in the [Inbox](https://docs.ainomos.ch/chat/inbox.md) as **Budget request**, titled with the amount per month. The item shows the reason, **Requested by**, and the current **Room budget**.

* **Accept**: the requested amount becomes the room's new monthly budget, with a hard stop. It replaces the old amount; it is not added to it.
* **Reject**: a reason is required, so the room owner knows why the room stays stopped.

Asking writes no evidence record. The decision does: it records who asked, the amount, who decided, and the budget before and after.

## Related

* [Models in Ainomos](https://docs.ainomos.ch/models/overview.md)
* [Inbox](https://docs.ainomos.ch/chat/inbox.md)
* [Rooms](https://docs.ainomos.ch/admin/rooms.md)
* [Audit log](https://docs.ainomos.ch/privacy/audit-log.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.