README.md

---
license: apache-2.0
language:
  - en
  - es
tags:
  - chatbot
  - rule-based
  - roblox
  - calculator
  - gradio
  - conversational
pipeline_tag: conversational
---

# NEO-1 — mdfjbots

> Rule-based conversational chatbot with a JSON knowledge base, Roblox API, math calculator, response variation and token-similarity matching.

[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
[![Python](https://img.shields.io/badge/python-3.10%2B-blue)](https://www.python.org/)
[![Gradio](https://img.shields.io/badge/gradio-4.44%2B-orange)](https://gradio.app/)

## Features

- **JSON knowledge base** — editable responses without touching code
- **Token similarity matching** — Spanish stopword filtering to avoid false positives
- **Response variation** — auto-reformulates answers to avoid repetition
- **Word-by-word streaming** — simulates real LLM output
- **Math calculator** — solves operations like `15 * 7 + 3`, `2 ** 8`
- **Roblox API** — searches players and games by name
- **Closed edition** — encrypted `respuestas.dat` via XOR + zlib + base64
- **NeoAPI REST** — Node.js/Express server for external integrations

## Repository

Source code: [github.com/mdfjbotss/neo-1](https://github.com/mdfjbotss/neo-1)

## License

Apache 2.0 — see [LICENSE](LICENSE)