PyRomusa AI — v0.10.0 🤖

• Version type: STABLE
• Release date: 2026-08-22

Overview

This version/framework focuses on creating a very simple, beginner-friendly chatbot system, built with:

• custom logic (Chatbot() object)
• real machine learning models (RealChatbot() object)

It exists to:

• help beginners understand how chatbot logic can work
• allow fast experimentation with simple AI-like behaviour
• avoid complex frameworks and heavy dependencies (Chatbot() object)

What makes it different:

• you can avoid neural networks, hidden layers, ML libraries (Chatbot() object)
• you can using LLM tehnologies (RealChatbot() object)
• fully custom, readable logic

This version implements two types of chatbot objects:

• Chatbot() (optimized for few training examples and hardware-undemanding)
• RealChatbot() (optimized for large, serious projects, real experimentation and hardware-demanding)

Files Included

General structure (exactly this structure will be found if you search in 📁all versions of this repository):

|-📁PyRomusa_AI - vX.Y.Z/
|----📄README.md
|
|----📁PyRomusa_AI/
|-------- 🐍PyRomusa_AI.py
|-------- 🐍errors.py
|
|-------- 📁Datasets/
|------------ more Python files...
|
|-------- 📁Reply_Engines/
|------------ more Python files...

More exact structure (if you search in the 📁src folder):

|- 📁src/
|--- ⚙️pyproject.toml
|--- 📄README.md
├─── 📁pyromusa_ai/
    |--- 🐍core.py
    |--- 🐍__init__.py
    |--- 🐍errors.py
    ├─── 📁Datasets
    └─── 📁Reply_Engines

Where:

What's New

• |RealChatbot() object| Bug fixed when loading a chatbot from a .pt file: An attempt was made to solve the problem so that when loading a pretrained model from a file, it would be possible to train it on new examples and, at the same time, preserve the previous pretraining process, without returning errors.

• |RealChatbot() object| Corrected parameter name learn_late -> learn_rate: A small spelling mistake in the name of a parameter in the bot.trainer.start() function has been corrected.

• |RealChatbot() object| Added word-level tokenizer: With the new word-level tokenizer, you have more possibilities to customize your chatbot the way you want. If you want faster training and the chatbot to look like it has 'hard-learned' to spell most words correctly, but more sensitivity if you misspell a word, then this tokenizer is perfect for you.

• |RealChatbot() object| Added auto checkpoint/ask to stop while training: Using the ask_to_stop_every_x_epochs and auto_checkpoint_every_x_epochs parameters from the bot.trainer.start() function, you can stop the chatbot training during training and periodically save the chatbot process.

• Update to the Romanian language dataset, 'Teacher for PyRomusa AI': It has been added more training examples to be able to answer more prompts. It is now a better dataset than in the previous version.

✅ STABLE release notice:

• The API is considered stable and ready for regular use
• Core logic is implemented and tested
• Behaviour is consistent across typical use cases
• Minor bugs may still exist, but no breaking changes are expected

Quick Usage Examples

1. Creating your first functional chatbot ever

from pyromusa_ai import Chatbot

# Create a chatbot
bot = Chatbot(chatbot_name="RomusaBot")

# Add training data
bot.trainer.add_data("Hello!", "Hi there!")
bot.trainer.add_data("Bye!", "Goodbye!")

# Start training
bot.trainer.start()

# Get a response
print(bot.reply_at("Hello!"))

2. Learn to start using the framework

from pyromusa_ai import Chatbot

# Create a chatbot
bot = Chatbot()

# Get help
bot.helper.how_to_start()

Note:

Depending on how you installed PyRomusa AI, this framework, in your code, must be imported like this, one of these 2 variants:

a) If you installed with pip install ...:

from pyromusa_ai import Chatbot

b) If you installed manually from this repository, preserving file names, from 📁all versions folder:

from PyRomusa_AI import Chatbot # If your code is located in the same folder as 🐍PyRomusa_AI.py

or

from PyRomusa_AI.PyRomusa_AI import Chatbot # If your code is in the same folder as the folder that has all the resources for PyRomusa AI (📁PyRomusa_AI)