Skip to content

Repository files navigation

ALTER SELF – AI WhatsApp Bot

ALTER SELF is an AI-powered WhatsApp bot that behaves like a digital personality, a future version of yourself, and a daily motivation system — all inside WhatsApp.

Unlike a typical chatbot, ALTER SELF is:

  • Memory-driven
  • Personality-based
  • Time-aware
  • Motivation-focused
  • AI-powered

Built using:

  • GoWA (WhatsApp Web bridge)
  • Next.js API Routes
  • Gemini AI
  • JSON-based memory

Features

Alter Ego Personality System

Switch personalities anytime.

Command: /mode

Available modes: default savage mentor coder therapist motivator poet spiritual professor startup

Example: /mode savage Bot response: Mode changed to savage


Message Your Future Self

Send reminders to your future self.

Command: /future

Examples: /future 10m Drink water /future 3h Study DSA /future 2d Apply to internships

After time passes: From your past self: Study DSA


AI Motivation System

Get automated AI-generated motivation at custom intervals.

Commands: motivation-on motivation-off motivation-time 2h motivation-time 30m motivation-time 1d

Messages are:

  • AI generated
  • Short
  • Calm
  • Fresh on every send

Memory System

Each user has independent memory:

  • Conversation history
  • Personality mode
  • Scheduled reminders
  • Motivation intervals

Everything is stored per phone number.


AI Brain

Powered by Gemini AI:

  • Dynamic response generation
  • Mode-based prompt shaping
  • History aware conversation
  • Daily motivation creation

Command Summary

Feature Command
Change personality /mode savage
Future reminder /future 5h message
Enable motivation motivation-on
Disable motivation motivation-off
Change motivation interval motivation-time 1h

File Structure

/api/message/route.js conversation-history.json user-mode.json future-messages.json motivation-users.json .env.local


Setup Instructions

1. Install dependencies

npm install


2. Create .env.local

GEMINI_API_KEY=YOUR_API_KEY


3. Run the server

npm run dev


4. Start WhatsApp bridge

bridge.exe rest --port=2000 --webhook=http://localhost:3000/api/message

Scan QR to login.


Why ALTER SELF is Unique

This is not a chatbot.

It is:

  • A habit engine
  • A reminder system
  • A motivation assistant
  • A personality machine
  • A productivity brain

All packed into WhatsApp.


Roadmap

Upcoming features:

  • AI journaling
  • Emotion awareness
  • Voice replies
  • Image generation
  • Goal tracking
  • Admin dashboard
  • Web UI
  • Cloud deployment

Author

Built by Pushkar.

Mission: Turn WhatsApp into a second brain.


About

An AI-powered WhatsApp bot built with Next.js and Gemini that acts as a digital personality, reminder system, and motivation engine.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages