| --- |
| title: Danish Villa Assistant |
| emoji: 🏡 |
| colorFrom: blue |
| colorTo: green |
| sdk: streamlit |
| sdk_version: "1.45.1" |
| app_file: src/app.py |
| pinned: false |
| short_description: AI-powered Danish real estate analysis |
| tags: |
| - real-estate |
| - ai |
| - streamlit |
| - nocodb |
| - together-ai |
| - property-analysis |
| --- |
| |
| # 🏡 Danish Villa Assistant |
|
|
| An AI-powered real estate analysis app that helps explore Danish villa properties with intelligent insights. Built with Streamlit, NocoDB, and Together AI for a digital innovation course. |
|
|
| ## Features |
|
|
| - **Property Database**: Browse Danish villa listings with detailed information |
| - **Smart Filtering**: Filter properties by price, rooms, city, and energy rating |
| - **AI Analysis**: Ask natural language questions about the property market |
| - **Real-time Data**: Connected to NocoDB for live property data |
| - **Multiple AI Models**: Choose from various Together AI models including Gemma |
|
|
| ## Tech Stack |
|
|
| - **Frontend**: Streamlit |
| - **Database**: NocoDB (no-code database) |
| - **AI/LLM**: Together AI (multiple model options) |
| - **Deployment**: Hugging Face Spaces |
|
|
| ## Setup Instructions |
|
|
| ### 1. Clone and Install Dependencies |
|
|
| ```bash |
| pip install -r requirements.txt |
| ``` |
|
|
| ### 2. Configure API Keys |
|
|
| You need to set up three secrets in your Hugging Face Spaces: |
|
|
| 1. `TOGETHER_API_KEY` - Get from [Together AI](https://api.together.xyz/) |
| 2. `NOCODB_API_TOKEN` - Your NocoDB API token |
| 3. `NOCODB_ENDPOINT_PATH` - Your NocoDB table endpoint path (e.g., `/api/v2/tables/TABLE_ID/records`) |
|
|
| ### 3. Run Locally |
|
|
| ```bash |
| streamlit run src/app.py |
| ``` |
|
|
| ## Deployment on Hugging Face Spaces |
|
|
| 1. Create a new Space on [Hugging Face Spaces](https://huggingface.co/spaces) |
| 2. Choose "Streamlit" as the SDK |
| 3. Upload all files (`src/app.py`, `requirements.txt`, `README.md`) |
| 4. Go to Settings → Repository secrets |
| 5. Add your three secret keys: |
| - `TOGETHER_API_KEY` |
| - `NOCODB_API_TOKEN` |
| - `NOCODB_ENDPOINT_PATH` |
|
|
| ## Usage |
|
|
| 1. **Filter Properties**: Use the sidebar to filter by price, rooms, location, and energy rating |
| 2. **Browse Listings**: View detailed property information in the main panel |
| 3. **Ask AI Questions**: Use the AI assistant to get insights about the market |
| 4. **Test Models**: Use the debug section to test different AI models |
|
|
| ## Example Questions for AI |
|
|
| - "What's the average price range?" |
| - "Tell me about energy ratings in the data" |
| - "Which areas have the most expensive properties?" |
| - "How many properties are available in each city?" |
| - "What's the price per square meter trend?" |
|
|
| ## Course Context |
|
|
| This app demonstrates key concepts in digital innovation: |
|
|
| - **No-code Database**: Using NocoDB for rapid data management |
| - **AI Integration**: Leveraging LLMs for natural language insights |
| - **Cloud Deployment**: Hosting on Hugging Face Spaces |
| - **Modern Web Apps**: Building with Streamlit for rapid prototyping |
|
|
| ## License |
|
|
| Built for educational purposes as part of a digital innovation course. |
|
|
| ## Support |
|
|
| For issues with: |
| - **Together AI**: Check [Together AI docs](https://docs.together.ai/) |
| - **NocoDB**: Check [NocoDB docs](https://docs.nocodb.com/) |
| - **Streamlit**: Check [Streamlit docs](https://docs.streamlit.io/) |
| - **Hugging Face Spaces**: Check [HF Spaces docs](https://huggingface.co/docs/hub/spaces) |
