QuietRoom / README.md
Francesco Laiti
Update README
37de0c2
metadata
title: QuietRoom
emoji: πŸ“”
colorFrom: blue
colorTo: purple
sdk: docker
pinned: true
license: gpl-3.0

QuietRoom

Your thoughts, your device. Period.

A privacy-first, multimodal journaling webapp that helps you capture and reflect on your daily experiences through photos, videos, audio recordings, text, and location data. QuietRoom leverages AI models to provide intelligent insights while maintaining your privacy.

Run locally

Prerequisites

  • Docker
  • For serving the Gemma3n model:
    • A Google API key if you have old hardware like me
    • Or Ollama installed and served locally on port 11434
    • Select the appropriate Gemma3n model in Settings

Using Docker

  1. Build the Docker image:

    docker build -t quietroom .
    
  2. Run the container:

    docker run -p 7860:7860 quietroom
    
  3. Access the application: Open your browser and navigate to http://localhost:7860

The Dockerfile automatically:

  • Sets up both Python backend and Node.js frontend environments
  • Installs all dependencies
  • Builds the frontend and serves it through the backend
  • Exposes the application on port 7860

Development Setup

For development with live reloading, you may want to run the backend and frontend separately:

Backend

cd backend
pip install -r requirements.txt # or uv sync
uvicorn app.main:app --reload --host 0.0.0.0 --port 7860

Frontend

cd frontend
npm install
npm run dev

How to cite

If you find this work interesting and you are using part or full code of it, please cite me:

@misc{laitifranz_quietroom,
    author  = "Francesco {Laiti}",
    title   = "QuietRoom | Your thoughts, your device. Period.",
    url     = "https://huggingface.co/spaces/laitifranz/QuietRoom",
    version = 0.1.0
    year    = 2025
}

Disclaimer

QuietRoom has been developed exclusively as a proof-of-concept for the "Google - The Gemma 3n Impact Challenge". It is not intended for use as a medical or therapeutic tool.