NumNuggets

Its a chatbot that delivers a daily dose of number trivia, pulling facts from the Numbers API — and optionally mixing in custom, India-centric number stories for cultural context. The experience should feel delightful, lightweight, and surprise-filled — like opening a fortune cookie for your brain. The goal is to spark learning through awe — not through lessons, but through delightful patterns, coincidences, and connections hidden in numbers.

🧩 Core Features

📬 Fun Fact of the day

● Every day morning, the bot sends one captivating fact tied to the current day.

📬 Surprise me

● User clicks on this button displayed on UI and the bot sends one captivating fact tied to a random number.

📬 Number Trivia

● User enters a number of his choice on UI and the bot sends one captivating fact tied to the number.

Problem Statement

For many students, numbers feel like lifeless equations — things to memorize, not explore. But what if we could breathe wonder into math by connecting numbers to stories, science, and surprises? Number Nuggets is a chatbot that turns every number into a fascinating fact. Whether it’s the birthday of a freedom fighter, the distance between Earth and Mars, or a quirky math property, the bot delivers one intriguing nugget a day — transforming numeracy into an adventure. Designed for middle and high school learners, this idea turns dry digits into memorable experiences. With a conversational interface and trivia-style interaction, it helps students build number sense, cross-subject awareness, and a lasting sense of curiosity.

Use cases:

• Number Trivia: “🔢 1729 is not just a number — it’s the famous Hardy–Ramanujan number! It’s the smallest number expressible as the sum of two cubes in two different ways.”
• Fun fact / Surprise me: “🔢 227 is the number of days Pi Patel was at sea in the popular novel, Life of Pi.””

Chat Bot API

A Node.js backend service for handling chatbot interactions using SwiftChat's bot platform, with Redis and PostgreSQL integration.

⚙️ Local Setup Instructions

Follow these steps to set up the repository on your local machine:

1. Install Required Services

• Redis: Download and install Redis from https://redis.io/download
• PostgreSQL: Download and install PostgreSQL from https://www.postgresql.org/download/

2. Setup SwiftChat Bot Credentials

You will need the following details from your SwiftChat bot configuration:

• Bot ID
• API Key
• API URL

These values will be used to configure your environment.

3. Create Environment Configuration

Create a .env file in the root directory with the following structure:

BOT_UUID=<bot_id>
KLUSTER_API_URL=https://put-url-here/api
KLUSTER_API_TOKEN=<token>

# Redis configuration
REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_PASSWORD=

# PostgreSQL configuration
PG_HOST=localhost
PG_PORT=5432
PG_USER=postgres
PG_PASSWORD=yourpassword
PG_DATABASE=chat_bot_db

# Application
PORT=3000

4. Install Dependencies

Run the following command to install all Node.js dependencies:

npm install

5. Seed the Database

Ensure PostgreSQL and Redis services are running. Then seed the database:

npm run seed

This will create the necessary tables and populate them with dummy data.

✅ Setup Complete

📹 Demo Video

▶️ Watch the demo

Swiftchat postman

📋 View Postman Documentation

🚀 Running the Application

Development Mode

To start the app with live-reloading:

npm run dev

Production Mode

To start the app in production:

npm start

Entry Point

The main entry file for the application is: app.js

🔄 Testing the App Locally

Once the app is running on the desired port:

• Use the SwiftChat Bot API to send test messages to the backend.

During local testing:

• The bot will send messages to the SwiftChat frontend.
• Messages from frontend → backend will not work directly.

To simulate this flow locally, use Postman or any other API testing tool along with the shared Postman collection.

🌐 Connecting Frontend and Backend via Localhost (NGROK)

⚠️ Disclaimer: NGROK's free plan has a limited number of requests and may become unreliable after exceeding those limits.

Steps:

1. Download NGROK from: https://ngrok.com/download

2. Start your local backend server:

npm run dev

3. Open an NGROK tunnel by running:

ngrok http <PORT>

(Replace <PORT> with the port your backend is running on.)

4. Open the NGROK inspector to view logs and details:

http://localhost:4040/inspect/http

5. Copy the public NGROK URL (e.g., https://xyz.ngrok.io).

6. Using the SwiftChat Platform API:

   • Call the get-webhook-url endpoint to check the current webhook.
   • Use the update-webhook-url endpoint to update it to the NGROK URL.

Now your frontend is connected to your backend running locally via NGROK. You can interact with buttons and send messages directly from SwiftChat frontend to your Node.js backend.