Skip to content

Passion is my AI-powered, node -based interactive chatbot designed to provide seamless, intelligent communication, relaying information about me in a more fun but effective way.

License

Notifications You must be signed in to change notification settings

Passion-Over-Pain/Passion

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Passion: AI-Powered Node-Based Chatbot

Passion

Passion is an advanced AI-powered chatbot built using Botpress and JavaScript, designed for intelligent, natural, and dynamic conversations. With multi-platform support, Passion seamlessly integrates with web platforms, WhatsApp, and Botpress Cloud, offering a highly interactive and feature-rich experience.

Powered by natural language processing (NLP) and enhanced with APIs, Passion can:
✅ Recognize and convert English speech to text
✅ Send and receive emails
✅ Play music on demand [Website Only]
Query databases for real-time information
Integrate with APIs & webhooks for enhanced automation

Tip

For the best experience, use Passion’s website version, which provides the fullest range of features. This version can be found on My Website.


📌 Table of Contents


🚀 Features

🔹 Conversational AI – Passion understands contextual conversations, thanks to GPT-4 integration.
🔹 Multi-Platform Deployment – Available on Botpress Cloud, Website, and WhatsApp.
🔹 Speech-to-Text – Converts spoken English into text for smooth interaction.
🔹 Email Communication – Send & receive emails directly from the chatbot.
🔹 Music Playback – Users can request and play songs via voice/text commands.
🔹 Database Integration – Queries databases dynamically based on user input.
🔹 Webhook & API Support – Integrates with external APIs for automation.


🖤 Bot Anatomy

Passion is a node-based chatbot, meaning that conversations flow from one entry point to another based on user actions. Below is the core architecture:

🔹 Nodes & Flow

  • Each conversation begins at an entry point and moves node-to-node.
  • The bot follows user inputs to determine the next logical step.

🔹 Triggers

  • Define how conversations start (e.g., user sends a message, selects a choice, or triggers an event).
  • Examples: "Hello", "Start", or a WhatsApp message received.

🔹 Events

  • Events handle real-time interactions, such as API responses, webhook triggers, or system notifications.
  • Example: A database query returns data, and Passion uses that to continue the conversation.

🔹 Memory & Context

  • The bot remembers user inputs within the session, allowing for context-aware conversations.

📌 Diagram: Node-Based Conversation Flow

graph TD;
    A[User Message] -->|Trigger Event| B[Botpress Node]
    B -->|Condition Met| C[API Call or DB Query]
    C -->|Returns Data| D[Response to User]
    D --> E[Next Interaction]
    E -->|Loop| B
Loading

💡 How It Works

Passion operates as a node-based chatbot, meaning conversations follow a structured flow, transitioning between different nodes based on user interactions.

🔹 Step-by-Step Process

1️⃣ User initiates a conversation

  • A trigger (e.g., a message, button click, or system event) activates Passion.

2️⃣ Node-based navigation

  • Passion moves through predefined conversation paths based on user input and system logic.

3️⃣ Decision-making

  • Conditions determine which path the conversation follows (e.g., user choices, API responses).

4️⃣ Execution of actions

  • Passion can send emails, fetch database records, recognize speech, or play music, depending on the interaction.

5️⃣ Real-time response generation

  • Using GPT-4 and NLP techniques, Passion understands context and responds dynamically.

🎭 Modes of Interaction

Passion offers three distinct modes of interaction, each tailored for a unique user experience:

Mode Description
Story Mode 🏰 A structured, guided conversation flow with predefined questions and choices. Best for interactive storytelling, onboarding, and structured dialogues where users progress through a designed path.
Sandbox Mode 🧩 An open-ended Q&A experience where users can freely ask questions and receive AI-driven responses. Ideal for general inquiries, discussions, and dynamic problem-solving.
Action Mode A specialized mode where Passion performs actions beyond regular conversation, such as sending emails, playing music, executing database queries, and interacting with APIs. Designed for task execution and automation.

🌍 Deployment Platforms

Passion is deployed across three platforms, each offering different levels of functionality.

Platform Description Features Limitations
Botpress Cloud (Native Link) The default hosting option for quick testing and deployment. 🔹 Basic chatbot functionality 🔹 Limited customization
Website Integration (Recommended) Hosted on my personal website, offering the most advanced functionality. 🔹 Email interactions (send/receive)
🔹 Speech recognition (convert speech to text)
🔹 Music playback
🔹 Database queries & API integrations
🔹 None (Best experience)
WhatsApp Business Integrated via a WhatsApp Business account, best for quick, text-based interactions. 🔹 Supports standard chatbot conversations 🔹 Limited multimedia support
🔹 No speech recognition or music playback

📌 Recommendation:
For the best experience, use Passion’s website version, as it supports all features without platform limitations.


📝 License

Copyright (c) 2025 Tinotenda Mhedziso. All Rights Reserved.

This software, its source code, and all related materials are proprietary and owned solely by [Tinotenda Mhedziso].
Unauthorized copying, modification, distribution, or resale of this software, in whole or in part, is strictly prohibited. Please see the LICENSE file.

Tip

In creation, you give a part of yourself, and in doing so, you offer something beautiful—not perfect, but uniquely yours, meant to be cherished.


Dev.to | Email | GitHub | LinkedIn | Website

About

Passion is my AI-powered, node -based interactive chatbot designed to provide seamless, intelligent communication, relaying information about me in a more fun but effective way.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published