Spaces:
Running
Running
| 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 | |
|  | |
| ### 🍳 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 | |
| ```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.” | |