Skip to content
 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ComeBack.ai

The AI Recovery Coach That Helps You Restart
Because most people don't fail — they just stop trying.

Build With AI Hackathon Google Cloud Gemini 2.5 MongoDB React TypeScript


🎯 The Problem We Solve

Every year, millions of people start goals with genuine intent. They create plans, set deadlines, and begin with enthusiasm. Then life happens. They miss a few days. Feel like failures. And quietly abandon their goals.

This is Silent Abandonment — the universal pattern where people don't fail because they lack knowledge or planning, but because they have no system to help them recover when they inevitably fall off track.

The Gap in Existing Solutions

App What It Does Well The Fatal Flaw
Notion AI Organization and planning No accountability or recovery system
Todoist Simple task management Tasks pile up, guilt builds, users quit
Motion AI scheduling Expensive and punishes failure
ChatGPT Great advice No long-term memory or follow-up
Habitica Gamification Punishes missed days, increases guilt
Duolingo Streak motivation Only works for language learning

The Pattern: All these apps reward success. None are built for failure. But failure is where users spend most of their time.


💡 Our Solution

ComeBack AI is an AI-powered recovery coach that helps students, professionals, and learners restart abandoned goals through intelligent recovery plans, compassionate accountability, and personalized coaching that understands failure is part of the journey.

How It Works

  1. Tell ComeBack AI your goal — "I want to become a frontend developer by December 2026"
  2. AI creates a realistic plan — Monthly milestones, weekly targets, daily tasks
  3. Daily check-ins — "Did you complete today's task?"
  4. When you miss days — AI creates a Recovery Plan (not punishment)
  5. Gradual momentum rebuild — Start with 15 minutes, gradually return to normal
  6. Continuous adaptation — AI learns your patterns and adjusts accordingly

The Magic Moment

When you return after 12 days of silence:

  • Other apps say: "You failed. Start over."
  • ComeBack AI says: "Welcome back. Let's rebuild your momentum together."

This changes everything.


✨ What Makes Us Unique

1. Recovery-First Design

Built specifically for people who have abandoned goals. The entire product is designed around the restart moment, not the start moment.

2. Compassionate AI

AI that understands failure is normal. No guilt trips. No punishment. Just intelligent support that meets you where you are.

3. Behavioral Intelligence

AI learns your patterns — when you struggle, what causes burnout, what helps you recover — and adapts your plan in real-time.

4. Voice-First Interaction

Talk to ComeBack AI like a real coach. No typing. No forms. Just conversation powered by Gemini 2.5.


🎯 Target Users

User Group Who They Are Their Pain Point How We Help
Tech Learners 18-30 year olds learning frontend, backend, DevOps, data analytics Abandon learning roadmaps after 2-3 weeks AI creates recovery plans that rebuild momentum gradually
University Students Undergrads and postgrads balancing academics, skills, internships Get overwhelmed by multiple goals AI prioritizes goals and detects burnout early
Young Professionals 22-35 year olds pursuing certifications, career growth, side hustles Buy courses but never finish them AI tracks real behavior and adjusts timelines

Market Size: 5-10 million users in Nigeria alone. Global potential is massive.


🚀 Core Features

Goal Creation & AI Planning

  • Natural language goal input
  • AI-generated monthly milestones
  • Weekly targets and daily tasks
  • Realistic timelines based on your capacity

Daily Check-Ins

  • Simple Yes/No/Partial responses
  • Voice message support (Gemini-powered)
  • Quick tap buttons for mobile
  • Contextual follow-up questions

The Recovery Engine ⭐ Core Feature

When you miss days, AI creates an intelligent Recovery Plan:

  • Day 1: 15 minutes (just show up)
  • Day 2: 30 minutes (build momentum)
  • Day 3: 45 minutes (getting back to normal)
  • Day 4: Back to your regular schedule

Burnout Detection

AI monitors your behavior patterns and proactively suggests:

  • Lighter targets when you're struggling
  • Rest days when needed
  • Breaking big tasks into smaller ones

Progress Journal

  • Weekly AI-generated summaries
  • Trend analysis over time
  • Pattern identification
  • Small win celebrations

Voice Coaching

Talk to AI like a real coach:

  • You: "I've been really tired this week"
  • AI: "I hear you. Let's reduce today's target to just 15 minutes. Sometimes showing up is enough."

🛠️ Technology Stack

Frontend

  • React 18.3 with TypeScript 5.6
  • Material-UI (MUI) v6 for UI components
  • Vite 6 for development and build
  • React Router v7 for navigation

Backend & AI

  • Node.js 20 with Express.js
  • Google Gemini 2.5 for AI agents (function calling, embeddings, multimodal)
  • MongoDB Atlas for database
  • JWT for authentication
  • Google Cloud Run for deployment

Infrastructure

  • Google Cloud Platform (Cloud Run, Secret Manager)
  • MongoDB Atlas (managed database cluster)
  • GitHub Actions for CI/CD

🤖 The Three AI Agents

1. Goal Planner Agent

Converts user goals into actionable plans using Gemini function calling.

  • Input: "I want to become a frontend developer by December 2026"
  • Output: Structured monthly milestones, weekly targets, daily tasks

2. Recovery Agent ⭐ Core Innovation

Creates intelligent recovery plans when users miss days.

  • Monitors days missed and completion patterns
  • Generates gradual recovery plans
  • Adjusts based on user response

3. Motivation Agent

Provides empathetic coaching and detects burnout.

  • Analyzes user language and completion patterns
  • Detects burnout signals early
  • Responds with compassionate messages

📦 Getting Started

Prerequisites

  • Node.js 20+ and npm 10+
  • Google Cloud CLI (gcloud)
  • MongoDB Atlas account
  • Google Cloud account with Gemini API access

Installation

# Clone the repository
git clone https://github.com/Oliversmoke/spark.git
cd spark

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env
# Add your MongoDB, Gemini API, and JWT credentials

# Start development server
npm run dev

Environment Variables

# MongoDB
MONGODB_URI=mongodb+srv://username:password@cluster.mongodb.net/comeback-ai

# Gemini AI
GEMINI_API_KEY=your_gemini_api_key

# JWT Authentication
JWT_SECRET=your_jwt_secret_key
JWT_EXPIRES_IN=7d

# Server
PORT=8080
NODE_ENV=development

Deployment to Cloud Run

# Build and deploy to Cloud Run
gcloud run deploy comeback-ai \
  --source . \
  --platform managed \
  --region us-central1 \
  --allow-unauthenticated

# Set environment variables
gcloud run services update comeback-ai \
  --update-env-vars MONGODB_URI=your_mongodb_uri,GEMINI_API_KEY=your_api_key

🏗️ Project Structure

comeback-ai/
├── client/                # React frontend
│   ├── src/
│   │   ├── components/   # React components
│   │   ├── services/     # API services
│   │   ├── hooks/        # Custom React hooks
│   │   └── types/        # TypeScript types
│   └── package.json
├── server/               # Node.js backend
│   ├── src/
│   │   ├── routes/      # API routes
│   │   ├── models/      # MongoDB models
│   │   ├── agents/      # AI agent logic
│   │   ├── middleware/  # Auth & validation
│   │   └── utils/       # Helper functions
│   ├── Dockerfile       # Cloud Run container
│   └── package.json
└── README.md

🎨 Design Philosophy

  • Compassion Over Punishment — Supportive interactions, not judgmental
  • Simplicity Over Complexity — Clean interfaces, clear language
  • Progress Over Perfection — Celebrate small wins and gradual improvement
  • Intelligence Over Automation — AI adapts to users, not the other way around

🌍 Impact & Vision

The Human Impact

Reframes Failure: People stop seeing themselves as failures and start seeing themselves as humans who are learning and growing.

Builds Self-Compassion: Users internalize the AI's compassion and become kinder to themselves.

Creates Sustainable Habits: Habits built on real capacity, not idealized versions of ourselves.

Reduces Shame: Normalizes failure and shows users they're not alone.

Increases Completion Rates: People with recovery systems are 3-5x more likely to complete goals.

Long-Term Vision

In 5 years, we want people to say:

"I used to abandon goals all the time. Then I found ComeBack AI. Now I finish what I start — not because I'm perfect, but because I have a system that helps me restart when I fall."


📊 Market Opportunity

  • 92% of people abandon New Year resolutions by February
  • 70% of online course buyers never finish the course
  • $96.36B global productivity app market by 2030
  • 2M+ university students in Nigeria
  • 500K+ Nigerians actively learning tech skills

The Gap: Huge market, but nobody is solving the recovery problem. This is a blue ocean opportunity.


🤝 Contributing

We welcome contributions! Fork the repository, create a feature branch, and submit a pull request.


📄 License

MIT License - see LICENSE for details.


👥 Team

Built with ❤️ by the Spark team for the Build With AI Hackathon, GDG Lagos 2026.


ComeBack AI — Helping people restart what they never should have stopped.

Get StartedView Demo

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages