README.md

---
license: other
library_name: ollama
tags:
  - haip
  - hotel
  - revenue-management
  - gguf
  - ollama
---

# HAIP AI

`haip-ai` is the optional **local** model for [HAIP](https://github.com/TelivityAI/haip)
(Hotel AI Platform). It produces compact, **grounded** explanations of HAIP's deterministic
agent decisions — it never executes actions and only reasons over the numbers the agents
already computed.

- Runs locally via **Ollama** (GGUF, Q4_K_M)
- Output is strict JSON: `{"rationale": string, "suggestions": string[]}`
- Held-out quality: **100% JSON-valid, 88.8% grounded** (via the exact runtime contract)

## Output contract

```
system: You are HAIP AI, a hotel revenue & operations analyst. ... Respond ONLY with compact
        JSON: {"rationale": string (<=60 words), "suggestions": string[] (0-3 short items)}.
user:   Agent: {agentType}\nDecision: {decisionType}\nNumbers:\n{json}
assistant: {"rationale": "...", "suggestions": ["..."]}
```

## Use with Ollama

```bash
# while this repo is private, configure your HF token first
ollama pull hf.co/telivity/haip-ai

# or download haip-ai.gguf + Modelfile, then:
ollama create haip-ai -f Modelfile
```

Enable in HAIP: `HAIP_AI_ENABLED=true HAIP_AI_MODEL=haip-ai` (opt-in — the PMS works fully without it).

## Attribution

See `THIRD_PARTY_LICENSES` in the [HAIP repo](https://github.com/TelivityAI/haip) for upstream
model attribution and their license terms.