https://github.com/wesley-archives/z3-r0
Z3-R0 simulates a chatbot experience through a custom-built intent-matching algorithm.
https://github.com/wesley-archives/z3-r0
alibabacloud bot chat hackaton
Last synced: 11 months ago
JSON representation
Z3-R0 simulates a chatbot experience through a custom-built intent-matching algorithm.
- Host: GitHub
- URL: https://github.com/wesley-archives/z3-r0
- Owner: wesley-archives
- License: mit
- Created: 2025-04-21T13:26:51.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-28T22:19:44.000Z (about 1 year ago)
- Last Synced: 2025-06-20T04:38:35.363Z (12 months ago)
- Topics: alibabacloud, bot, chat, hackaton
- Language: TypeScript
- Homepage: https://z3-r0.vercel.app
- Size: 4.03 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🤖 Z3-R0
**Z3-R0** is my submission for the [Alibaba Cloud Web Game Challenge](https://dev.to/devteam/join-us-for-the-alibaba-cloud-web-game-challenge-3000-in-prizes-1n5d?bb=220943) — a creative contest that invites developers to build robot-themed games or experiences using web technologies and Alibaba Cloud services.
Rather than using real AI or NLP services, **Z3-R0 simulates a chatbot experience** through a custom-built intent-matching algorithm. It analyzes user input patterns and responds with scripted interactions, creating the illusion of intelligence and personality — all handled entirely on the frontend with no backend or cloud processing required.
Built with **React**, **TypeScript**, and **Vite**, Z3-R0 is designed to be fast, playful, and easy to deploy, making it perfect for lightweight hosting environments like Alibaba Cloud's OSS or ECS.
## 📌 Table of Contents
- [Features](#-features)
- [Demo](#-demo)
- [Getting Started](#-getting-started)
- [Usage](#-usage)
- [Contributing](#-contributing)
- [License](#-license)
- [Acknowledgements](#-acknowledgements)
## 💡 Features
- 🎮 **Interactive commands**: gifs, memes, jokes, quotes, games, music & more
- 🗣️ **Text-to-speech**: Uses the Web Speech API to speak responses aloud
- 🧠 **Simulated conversation**: Predefined behavior patterns for quirky dialogue
- 💤 **Idle detection**: Reacts with surprises when you’re inactive
- 🌍 **Multi-language support**: EN, ES, PT, CH, HI
- 💾 **Persistent local storage**: Saves language preference and last 20 messages
- 🛰️ **Dynamic status messages**: Adds personality with randomized system statuses
- 🎭 **Smooth UI transitions**: Online/offline animations and effects
- 🔔 **Browser Notifications**: Alerts you when Z3-R0 is ready to chat
- 🐳 **Docker-ready**: For clean builds and easy deployment
## 🚀 Demo
A preview of Z3-R0 in action:
> Try Z3-R0 now, live on [z3-r0.vercel.app](https://z3-r0.vercel.app/).
## ⚡ Get Started
### Prerequisites
- Node.js (v18+ recommended)
- Docker (optional, for containerized build)
### Clone the Repository
```bash
# Clone the repository
git clone https://github.com/wesleybertipaglia/z3-r0.git
# Navigate into the project folder
cd z3-r0
```
### Run Locally
```bash
# Install dependencies
npm install
# Start the development server
npm run dev
```
### Run in Docker
```bash
# Build the Docker image
docker compose up -d
```
## 🛠️ Usage
Once the bot is live, try typing:
- `!gif` to get a random gif
- `!meme` to fetch a meme
- `!joke` for a random joke
- `!quote` for a motivational quote
- `!game` to get a list of available games
- `!hangman` to play Hangman
- `!trivia` to test your trivia knowledge
- `!music` to listen to some tunes
- `!help` for a list of commands
Z3-R0 keeps the chat engaging, even when you’re AFK 😎
## 🤝 Contributing
Contributions are welcome! If you have any suggestions or improvements, please open an issue or a pull request.
## 📄 License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.
## Acknowledgements
- [ChatGPT](https://openai.com/blog/chatgpt) for the robot's profile image.
- Sound Effect by freesound_community from Pixabay
- Musics from [Spotify Embedded API](https://developer.spotify.com/documentation/web-playback-sdk/quick-start/)