Skip to content

Jade-ok/YouCode2026_Clover

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

74 Commits
 
 
 
 
 
 
 
 

Repository files navigation

🐾 CareHandoff

Voice-powered care handoff tool for animal shelters. > Built at YouCode 2026 by Team Clover 🍀


💡 The Problem

Nonprofit organizations face high volunteer and staff turnover with limited resources for structured handoffs. When people leave, critical knowledge leaves with them — often undocumented.

CareHandoff turns voice into structured records. Speak for 30 seconds, and the system captures and organizes everything for the next person. No forms, no training.

Built for animal shelters where the problem is most urgent, but designed to scale across any nonprofit where people rotate and knowledge gets lost.


🚀 The Solution

CareHandoff is a seamless, voice-first dashboard. Volunteers simply speak their updates after checking on an animal. The app automatically transcribes the audio, extracts key alerts, and generates a structured care log.


Highly Accessible & Cost-Effective: Volunteers can speak in their native languages, and the app unifies the output in English so the entire team shares a readable, common record. Thanks to our optimized AI pipeline, processing a complete check-in costs less than 1 cent.


✨ Features

  • 🎙️ Voice-to-Insights: Multilingual voice input (Korean, Mandarin, Punjabi, etc.) with automatic English transcription for team-wide accessibility.
  • 🧠 AI Task Extraction: Automatically pulls active alerts and pending tasks from the spoken update.
  • 🔍 Interactive Transcript: Hover over any alert or task to instantly highlight the source phrase in the transcript.
  • 🐾 Shelter Dashboard: A clean, centralized view to browse all animals, care histories, and to-do lists at a glance.

🛠 Tech Stack

  • Frontend: Next.js, TypeScript, Tailwind CSS, shadcn/ui
  • Backend: FastAPI (Python)
  • AI: OpenAI Whisper (Speech-to-Text) + GPT-4o-mini (Data Extraction)



💻 Getting Started

Follow these steps to run CareHandoff locally.

Backend Local Setup & Run Instructions

  1. Navigate to the backend directory:

    cd backend
  2. Create a .env file in the backend folder and add: OPENAI_API_KEY=your_key_here

  3. Create and activate a virtual environment (Recommended):

    • Windows (Command Prompt / PowerShell):
      python -m venv venv
      venv\Scripts\activate
    • Windows (Git Bash):
      python -m venv venv
      source venv/Scripts/activate
    • Mac/Linux:
      python3 -m venv venv
      source venv/bin/activate
  4. Install dependencies:

    pip install -r requirements.txt
  5. Run the FastAPI server:

    uvicorn main:app --reload
  6. Test the API: Open your browser and navigate to:


Frontend Local Setup & Run Instructions

  1. Navigate to the frontend directory:

    cd frontend
  2. Install dependencies:

    npm install
  3. Run the development server:

    npm run dev
  4. View the application: Open your browser and navigate to: http://localhost:3000

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors