---

title: Home
emoji: 🏆
colorFrom: yellow
colorTo: green
sdk: gradio
sdk_version: 5.49.1
app_file: app.py
pinned: false


tags:
  - build-small
  - thousand-token-wood
  - best-agent
  - off-brand
  - codex

---

# 🏡 Home — AI Memory House

**Home** is an interactive AI-powered memory house built for the *Build Small Hackathon*.
Instead of a traditional chatbot, Home turns AI into a **living environment you can explore** — rooms, memories, ambience, and emotional interaction all combined.

---

## ✨ Live Demo

🔗 Hugging Face Space:
**[👉 Open Home App](https://huggingface.co/spaces/build-small-hackathon/HOME)**

🎥 Demo Video:
**[▶ Watch Demo Video](https://youtu.be/oanGVNQuduE)**

## 📢 Social Media Post

🔗 X (Twitter) Post:
https://x.com/syedaalizah6/status/2066236561163968796?s=20

📸 Screenshots:

### 🏠 Landing / Entrance


![image](https://cdn-uploads.huggingface.co/production/uploads/67b1b1722ddc61229ecd67d8/m9BkJ9xim1A6j2Oyl4YOs.png)


### 🍳 Kitchen (Mom Chat Experience)


![image](https://cdn-uploads.huggingface.co/production/uploads/67b1b1722ddc61229ecd67d8/dQSGP_dgcbk1q6XoMVywG.png)

### 🔥 Ambience Controls (Rain / Fire / Forest)


![image](https://cdn-uploads.huggingface.co/production/uploads/67b1b1722ddc61229ecd67d8/wecnPnOcHKEdghVKJ2Zqy.png)

### 🐱 Memory Discovery (Cat + Letter System)


![image](https://cdn-uploads.huggingface.co/production/uploads/67b1b1722ddc61229ecd67d8/lKJ2WxRSpPIr_CNyW5bq2.png)

### 🧠 Memory Hallway


![image](https://cdn-uploads.huggingface.co/production/uploads/67b1b1722ddc61229ecd67d8/e3BjatsRIwigtBR6dotyV.png)

### 🌿 Garden Scene


![image](https://cdn-uploads.huggingface.co/production/uploads/67b1b1722ddc61229ecd67d8/UjhnYj4oki6tTCjN-V0yO.png)

---

## 🧠 Concept

Home reimagines AI not as a chatbot, but as a **space with memory and personality**.

Each room behaves differently:

* 🍳 Kitchen → Conversational AI (Mom persona)
* 🔥 Ambience System → Emotional environment control
* 🐱 Cat Interaction → Random memory discovery events
* 📜 Letters → Story fragments hidden in the house
* 🧠 Hallway → Persistent memory archive
* 🌿 Garden → Reflection space / ending area

---

## 🤖 Active Model

* Runtime Provider: **Groq**
* Model: `llama-3.1-8b-instant`
* HF Reference: `meta-llama/Llama-3.1-8B-Instruct`
* Parameters: **8B**
* ✔ Under Build Small limit (≤32B)
* ✔ Open-weight model

No proprietary cloud models are used.

Fallback system:

* Local deterministic “Mom responses” only (non-AI fallback)

---

## 🏗️ Architecture

* `app.py` → Gradio backend + API layer
* `dist/` → React + Vite frontend (house UI)
* `public/` → audio + video + assets
* Hugging Face Space → deployment host

Frontend is embedded inside Gradio using iframe-style mounting.

---

## 🧪 Key Features

* 🏡 Multi-room interactive UI
* 💬 Emotional AI chat (Mom persona)
* 🌦️ Dynamic ambience system
* 🐱 Event-based storytelling (cat + letters)
* 🧠 Persistent memory hallway
* 🎮 Game-like exploration flow

---

## 🚀 Codex Contribution

Codex was used in multiple development commits across this repository including UI integration, deployment fixes, and refactoring. These changes are reflected in git history.

Codex was used for:

* Gradio integration cleanup
* Build Small compliance fixes (≤32B rule)
* Hugging Face Space deployment fixes
* Repo restructuring + debugging
* UI + backend integration support

---

## 🛠️ Local Setup

```bash
pip install -r requirements.txt
npm install
npm run build
python app.py
```

Set environment:

```
GROQ_API_KEY=your_key_here
```

---

## 🏆 Build Small Hackathon Tags

* Thousand Token Wood (Whimsical AI experience)
* Best Agent (stateful AI house system)
* Off Brand (custom UI beyond default Gradio)
* Codex (AI-assisted development workflow)

---

## 📌 Notes

* Fully compliant with ≤32B parameter rule
* Uses only open-weight model (LLaMA 3.1 8B)
* No restricted API dependency required for core functionality

Note: This project targets Build Small “Thousand Token Wood” + “Best Agent” categories and does not target Tiny Titan.
---

## 🌟 Vision

> “Home is not a tool. It is a place that remembers you.”