> For the complete documentation index, see [llms.txt](https://docs.irislabs.co.uk/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.irislabs.co.uk/readme.md).

# Welcome to IRIS

**Welcome to IRIS**

IRIS is a cloud cost intelligence platform that gives you complete visibility into your AWS spend and AI API costs — across every account, region, and service — in one place.

IRIS connects to your AWS accounts using a secure cross-account IAM role and scans for cost and utilisation data automatically. No agents to install, no code to deploy. Connect an account, and IRIS does the rest.

***

**AWS Cost Management**

* Monitor month-to-date spend and daily cost trends across multiple AWS accounts and regions
* Get month-end forecasts and annual run rate projections based on your current usage
* View cost broken down by service — EC2, ECS, RDS, S3, Lambda, ELB, ElastiCache, DynamoDB, and more
* Detect cost anomalies automatically using AWS Cost Explorer's anomaly detection engine
* Browse every scanned resource with projected monthly cost, region, and rightsizing hints
* Review up to 12 months of historical spend with month-on-month percentage changes

***

**AI API Cost Tracking**

* Connect your OpenAI and Anthropic admin keys to track AI API spend alongside your AWS costs
* Monitor spend by model, project, workspace, user, and API key
* Get 30-day totals, month-to-date spend, and end-of-month forecasts for your AI usage
* View your full OpenAI organisation — members, projects, API keys, rate limits, and pending invites

***

**Budgets & Alerts**

* Set spending thresholds at any level — per resource, per account, across your whole org, or on AI spend specifically
* Get alerted via email, Slack, or Microsoft Teams when spend approaches or breaches a threshold
* Configure real-time cost alerts that fire within \~60 seconds of a scan when any resource exceeds a threshold
* Receive a weekly email digest of your AWS costs, rightsizing opportunities, and savings recommendations

***

**Ask IRIS**

* Ask questions about your cloud costs in plain English — "What is my highest-cost service this month?", "Are there any anomalies?", "Which resources have seen the biggest cost increase?"
* Deep dive into any specific resource directly from the Resources page — IRIS loads full resource context and analyses it on demand

***

**Multi-account support**

IRIS supports connecting multiple AWS accounts simultaneously — production, staging, dev, sandbox, or any combination. Each account is scanned independently across your chosen regions, and you can switch between them instantly in the dashboard.

***

**Getting started takes about 10 minutes.** Head to the Getting Started guide to connect your first AWS account.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.irislabs.co.uk/readme.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
