Skip to main content

A Python package for Generative AI applications

Project description

OmniGenAI Toolkit

OmniGenAI Toolkit is a lightweight, rule-based AI chatbot written entirely in Python. It requires no external model downloads, making it perfect for educational use, rapid prototyping, or extending into more advanced AI tools.


๐Ÿ”ง Features

  • โœ… Regex-based pattern matching chatbot
  • โœ… Customizable responses
  • โœ… Fallback logic with keyword detection
  • โœ… 100% Python Standard Library โ€” no downloads or external dependencies
  • โœ… Unit tested and modular structure

๐Ÿ“ฆ Installation

Clone and install the package locally:

git clone https://github.com/gopalakrishnanarjun/omnigenai_toolkit.git
cd omnigenai-toolkit
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install .

๐Ÿš€ Usage

To run the example chatbot:

python examples/run_chat.py

๐Ÿ’ฌ Example Session

You: hello
Bot: Hi there!

You: what is your name
Bot: I'm SmartAI, your simple Python chatbot.

You: what time is it?
Bot: The current time is 14:32:08.

You: bye
Bot: Goodbye! ๐Ÿ‘‹

๐Ÿ—‚ Project Structure

omnigenai-toolkit/
โ”œโ”€โ”€ docs/                   # Documentation (optional)
โ”œโ”€โ”€ examples/               # Example usage scripts
โ”‚   โ””โ”€โ”€ run_chat.py
โ”œโ”€โ”€ omnigenai_toolkit/      # Main module code
โ”‚   โ””โ”€โ”€ chatbot.py
โ”œโ”€โ”€ tests/                  # Unit tests
โ”‚   โ””โ”€โ”€ test_chatbot.py
โ”œโ”€โ”€ .gitignore
โ”œโ”€โ”€ LICENSE
โ”œโ”€โ”€ README.md
โ””โ”€โ”€ setup.py

๐Ÿง  How It Works

  • Uses re to match user input against predefined patterns.
  • Returns randomized responses for variety.
  • If no match is found, falls back to simple keyword checks like "time" or "weather".

๐ŸŒฑ Future Enhancements

๐Ÿ”น Short-Term

  • Store patterns and responses in external JSON/YAML
  • Add chatbot personality profiles (e.g., sarcastic, friendly)

๐Ÿ”น Medium-Term

  • Add memory/context support for ongoing conversations
  • Create web interface using Flask or FastAPI

๐Ÿ”น Long-Term

  • Integrate voice input/output
  • Use cloud APIs (optional) for GPT-style responses
  • Add multilingual support and translation layer

๐Ÿค Contributing

  1. Fork the repo
  2. Create a new feature branch
  3. Push your changes and open a Pull Request

All contributions are welcome โ€” from typo fixes to new features!


๐Ÿ“„ License

This project is licensed under the MIT License โ€” free to use, modify, and distribute.


โœจ Author

Built with โค๏ธ by Gopalakrishnan Arjunan (https://github.com/gopalakrishnanarjun)


๐Ÿ™Œ Acknowledgments

Inspired by early rule-based AI bots like ELIZA and built for offline-friendly simplicity.

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

omnigenai_toolkit-1.0.1.tar.gz (3.8 kB view details)

Uploaded Source

Built Distribution

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

omnigenai_toolkit-1.0.1-py3-none-any.whl (3.9 kB view details)

Uploaded Python 3

File details

Details for the file omnigenai_toolkit-1.0.1.tar.gz.

File metadata

  • Download URL: omnigenai_toolkit-1.0.1.tar.gz
  • Upload date:
  • Size: 3.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.0

File hashes

Hashes for omnigenai_toolkit-1.0.1.tar.gz
Algorithm Hash digest
SHA256 ad320d5bfcf5d86c6d960cbdea508feb9bb86bab04a07089f3bef1bf9f238661
MD5 e99ec6cc7c1399298c805326410635ea
BLAKE2b-256 737aa2bbe3b2361cc31f2e8389bfd537eae2e9f000f737b93a8e95d064a8460e

See more details on using hashes here.

File details

Details for the file omnigenai_toolkit-1.0.1-py3-none-any.whl.

File metadata

File hashes

Hashes for omnigenai_toolkit-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 07dcbcbe1eaa7292c3fb90bfbc440405d32640c54fe932e8a1c3cc17e058096f
MD5 ce4d042bc1d97683f7657a18dc47673a
BLAKE2b-256 43f058d69870ffb1d173721e07a48fd05fb214a370274a58d5d8e085c4ec593a

See more details on using hashes here.

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