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
reto 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
- Fork the repo
- Create a new feature branch
- 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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ad320d5bfcf5d86c6d960cbdea508feb9bb86bab04a07089f3bef1bf9f238661
|
|
| MD5 |
e99ec6cc7c1399298c805326410635ea
|
|
| BLAKE2b-256 |
737aa2bbe3b2361cc31f2e8389bfd537eae2e9f000f737b93a8e95d064a8460e
|
File details
Details for the file omnigenai_toolkit-1.0.1-py3-none-any.whl.
File metadata
- Download URL: omnigenai_toolkit-1.0.1-py3-none-any.whl
- Upload date:
- Size: 3.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
07dcbcbe1eaa7292c3fb90bfbc440405d32640c54fe932e8a1c3cc17e058096f
|
|
| MD5 |
ce4d042bc1d97683f7657a18dc47673a
|
|
| BLAKE2b-256 |
43f058d69870ffb1d173721e07a48fd05fb214a370274a58d5d8e085c4ec593a
|