README.md

metadata

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

🎥 Demo Video: ▶ Watch Demo Video

📢 Social Media Post

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

📸 Screenshots:

🏠 Landing / Entrance

🍳 Kitchen (Mom Chat Experience)

🔥 Ambience Controls (Rain / Fire / Forest)

🐱 Memory Discovery (Cat + Letter System)

🧠 Memory Hallway

🌿 Garden Scene

---

🧠 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

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.”