Skip to main content

A lightweight Python framework for creating simple AI chatbots with minimal code.

Project description

PyRomusa AI — v0.9.0 🤖

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

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 📁pyromusa-ai folder):

|-📁pyromusa-ai/
|----📄README.md
|----⚙️pyproject.toml
|
|----📁pyromusa_ai/
|-------- 🐍core.py
|-------- 🐍errors.py
|-------- 🐍__init__.py
|
|-------- 📁Datasets/
|------------ more Python files...
|
|-------- 📁Reply_Engines/
|------------ more Python files...

Where:

File/Folder name Description
📁PyRomusa_AI - vX.Y.Z , 📁pyromusa-ai/ The main folder containing everything for that version of the framework (full framework code + 📄README.md)
📄README.md Documentation for this specific version
📁PyRomusa_AI/ , 📁pyromusa_ai/ The secondary folder, which only has all the code that contributes to the 100% functional PyRomusa AI
🐍PyRomusa_AI.py , 🐍core.py The main/core code of PyRomusa AI
📁Datasets/ Folder with some optional code for the main framework code (🐍PyRomusa_AI.py) for ready-made data to train your chatbot
⚙️pyproject.toml A very important file to be able to install with pip install, but completely useless if you install PyRomusa AI manually
🐍errors.py A new file from 0.6.0, here you find different types of errors that you can catch in PyRomusa AI
📁Reply_Engines/ The folder containing the most important lines of code for the main goal of PyRomusa AI. These lines of code are mandatory for generating responses based on a prompt.

What's New

  • The new object, RealChatbot(): Do you want to train a real, yet untrained LLM architecture on your own Q&A examples? Then this is the perfect chatbot type for you.

  • 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 git+https://github.com/Robertinoos13/PyRomusa-AI-Library.:

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)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyromusa_ai-0.9.0.tar.gz (269.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pyromusa_ai-0.9.0-py3-none-any.whl (280.2 kB view details)

Uploaded Python 3

File details

Details for the file pyromusa_ai-0.9.0.tar.gz.

File metadata

  • Download URL: pyromusa_ai-0.9.0.tar.gz
  • Upload date:
  • Size: 269.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for pyromusa_ai-0.9.0.tar.gz
Algorithm Hash digest
SHA256 19502a56e20103f5f4467836d44bdc8387a4442687d1e7eb3b4e28959725c2d7
MD5 71b3ee10270ede65d1c0b7df85121547
BLAKE2b-256 58ab667db1a97bdc21437108f1ab9aba103d9ae125a2e414e1e55b9b11c07db7

See more details on using hashes here.

Provenance

The following attestation bundles were made for pyromusa_ai-0.9.0.tar.gz:

Publisher: publish.yml on Robertinoos13/PyRomusa-AI-Library

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pyromusa_ai-0.9.0-py3-none-any.whl.

File metadata

  • Download URL: pyromusa_ai-0.9.0-py3-none-any.whl
  • Upload date:
  • Size: 280.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for pyromusa_ai-0.9.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9112ce9ae98551725f0bbdd15f9873bdd2e17312dcb36cfbf3cee4044353b925
MD5 fa866e1c1dbc2cbaca72e803fff4c49e
BLAKE2b-256 64fa5e70e4ff0a82d71367f52870d34234cc32d699e3a3a919e81f32acaf46ff

See more details on using hashes here.

Provenance

The following attestation bundles were made for pyromusa_ai-0.9.0-py3-none-any.whl:

Publisher: publish.yml on Robertinoos13/PyRomusa-AI-Library

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page