PyRomusa AI — v0.10.1 🤖

• Version type: STABLE
• Release date: 2026-09-07

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| Fixed PyTorch FutureWarning: When you wanted to load a chatbot from a .pt file, then tried to train it on new training examples, you would get a FutureWarning due to the torch dependency. In the current version, you will no longer get any warnings in this situation (tested with torch == 2.5.1+cu121)

• |RealChatbot() object| Exagerated spaces generation after fine-tuning tried to be fixed: After training your chatbot on new examples and testing it by generating text, the result was a strange one with a lot of spaces and no logic. Now an attempt has been made to reduce this strange symptom.

• |RealChatbot() object| Fixed Teacher for PyRomusa AI loading system for RealChatbot(): Due to the incompatible format of the loading system of this prepared dataset and the RealChatbot() object, the training examples are never loaded in their entirety, thus having an error in the console, even if you did everything correctly. From this version, you will no longer have incomplete loads or unexplained errors related to loading this type of dataset.

• |RealChatbot() object| New function, bot.show_basic_specs(): Do you want to see the chatbot's specifications, training information, or even some details about the uploaded and/or learned training data? If you want that, just call this function and read what interests you.

• |RealChatbot() object| New parameters on bot.trainer.start() function, fine_tune_only_new_data, freeze_base_layers, show_suplimentary_info_in_console: Several new parameters available for training, to modify according to your needs.

• |RealChatbot() object| Optimized the fine-tuning training speed: Previously, when fine-tuning, you had to retrain the chatbot from 0 (with new + old data), which was an inefficient and time-consuming process. Now it is possible to train it strictly on new data only, reducing training time.

• 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)