Skip to content

Latest commit

Β 

History

14 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 

Repository files navigation

πŸ€– Aicatbot

A Simple AI Chatbot Interface using BotPress

HTML5 BotPress JavaScript

Live Demo β€’ Report Bug β€’ Request Feature


πŸ“– About The Project

Aicatbot is a simple, lightweight chatbot interface built using pure HTML and the BotPress web chat widget. This project demonstrates how easy it is to integrate a conversational AI chatbot into a website without any complex backend setup.

Perfect for beginners learning web development and AI integration!

✨ Why This Project?

  • No Backend Required: Just HTML and BotPress widget
  • Easy to Understand: Simple, clean code
  • Quick Setup: Get running in minutes
  • Fully Functional: Real AI conversations
  • Beginner Friendly: Great for learning

🎯 Features

  • πŸ€– AI-Powered Chat: Intelligent responses using BotPress
  • πŸ’¬ Simple Interface: Clean, user-friendly design
  • πŸ“± Responsive: Works on all devices
  • ⚑ Fast Loading: Lightweight HTML structure
  • 🎨 Customizable: Easy to modify styles and appearance

πŸ› οΈ Built With

πŸ“„  HTML5            - Structure
🎨  CSS3             - Styling
⚑  JavaScript       - Interactivity
πŸ€–  BotPress Widget  - AI Chat Functionality

πŸ“‚ Project Structure

πŸ“¦ Aicatbot/
β”‚
β”œβ”€β”€ πŸ“œ index.html        # Main HTML file
β”œβ”€β”€ πŸ“œ README.md         # Documentation
└── πŸ“œ .gitignore        # Git ignore file

Simple and straightforward! πŸŽ‰


πŸš€ Getting Started

Prerequisites

All you need is:

  • A web browser (Chrome, Firefox, Safari, etc.)
  • A text editor (VS Code, Notepad++, etc.)
  • Internet connection (for BotPress widget)

Installation & Setup

  1. Clone the repository

    git clone https://github.com/Ujjwal-Kumar6/Aicatbot.git
    cd Aicatbot
  2. Open the file

    • Simply open index.html in your web browser
    • That's it! No installation needed πŸŽ‰
  3. Start chatting

    • The chatbot will load automatically
    • Click the chat icon to start a conversation

πŸ’‘ How It Works

The project uses the BotPress web chat widget, which is embedded in the HTML:

<!DOCTYPE html>
<html>
<head>
    <title>Aicatbot</title>
</head>
<body>
    <!-- Your page content -->
    
    <!-- BotPress Chat Widget -->
    <script src="https://cdn.botpress.cloud/webchat/v1/inject.js"></script>
    <script>
        window.botpressWebChat.init({
            botId: "your-bot-id",
            hostUrl: "https://cdn.botpress.cloud/webchat/v1",
            messagingUrl: "https://messaging.botpress.cloud",
            clientId: "your-client-id"
        });
    </script>
</body>
</html>

The widget handles all the AI functionality - you just need HTML! πŸš€


🎨 Customization

Change Bot Appearance

You can customize the chat widget by modifying the init parameters:

window.botpressWebChat.init({
    botId: "your-bot-id",
    hostUrl: "https://cdn.botpress.cloud/webchat/v1",
    messagingUrl: "https://messaging.botpress.cloud",
    clientId: "your-client-id",
    // Customization options
    botName: "Aicatbot",
    botAvatar: "https://your-avatar-url.com/image.png",
    backgroundColor: "#6C63FF",
    textColorOnBackground: "#ffffff"
});

Add Custom Styles

Add CSS to style your page:

body {
    font-family: Arial, sans-serif;
    background-color: #f5f5f5;
}

.container {
    max-width: 1200px;
    margin: 0 auto;
    padding: 20px;
}

πŸ“ Usage

For Users

  1. Open the website
  2. Click the chat icon (usually bottom-right)
  3. Type your message
  4. Get instant AI responses!

For Developers

  1. Fork this repository
  2. Modify index.html with your own BotPress bot credentials
  3. Customize the design and layout
  4. Deploy to GitHub Pages or any hosting service

🌐 Deployment

GitHub Pages (Free & Easy!)

  1. Go to your repository settings
  2. Scroll to "Pages" section
  3. Select main branch as source
  4. Click Save
  5. Your site will be live at: https://username.github.io/Aicatbot/

Other Options

  • Netlify: Drag and drop deployment
  • Vercel: Connect your GitHub repo
  • Any Web Server: Just upload the HTML file

πŸŽ“ What I Learned

Building this project taught me:

  • βœ… How to integrate third-party widgets
  • βœ… Basic HTML structure
  • βœ… Working with CDN scripts
  • βœ… Deploying static websites
  • βœ… Creating interactive web interfaces
  • βœ… Understanding AI chatbot integration

πŸ› οΈ Future Enhancements

  • Add custom styling and themes
  • Create landing page design
  • Add multiple language support
  • Include loading animations
  • Add chat history feature
  • Create mobile app version
  • Add voice input capability

🀝 Contributing

Want to make this project better? Contributions are welcome!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

πŸ’‘ Tips for Beginners

  • Start Simple: This project is perfect for beginners
  • Experiment: Try changing colors, fonts, and layouts
  • Learn by Doing: Modify the code and see what happens
  • Ask Questions: Check the Issues section for help
  • Share Your Work: Deploy it and show your friends!

πŸ“š Resources


❓ FAQ

Q: Do I need to know programming?
A: Basic HTML knowledge is enough! The AI is handled by BotPress.

Q: Is this free to use?
A: Yes! Both the code and BotPress widget have free tiers.

Q: Can I use my own bot?
A: Yes! Just replace the bot credentials with your own.

Q: Does this work offline?
A: No, it needs internet to connect to BotPress servers.


πŸ“„ License

This project is open source and available under the MIT License.


πŸ‘¨β€πŸ’» Author

Ujjwal Kumar

Class 10 Student | Web Developer | AI Enthusiast

Building cool projects while learning web development

GitHub


πŸ’¬ About Me

I'm a Class 10 student passionate about technology and AI. This is one of my projects where I'm exploring how to integrate AI chatbots into websites. I believe in learning by building, and I hope this project inspires other students to start coding!


πŸ™ Acknowledgments

  • Thanks to BotPress for the amazing free widget
  • Inspired by modern chatbot interfaces
  • Built while learning HTML and web development
  • Thanks to the developer community for support

πŸ“ž Get in Touch


⭐ Star This Repo!

If you found this helpful, please give it a star! ⭐

It motivates me to create more projects like this πŸš€


Made with ❀️ by a Class 10 Student

Proof that you're never too young to start coding!

Star Follow

About

by using botpress

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages