Hi Cutie
Project description
askOmi
AI-powered HTML response generator with inline and separate file output options.
Features
- AI-Powered Responses: Uses Google's Gemini AI to generate intelligent responses
- Flexible Output Options:
- Generate responses in separate HTML files
- Add responses inline to existing HTML files
- Easy Integration: Simple Python functions for quick implementation
- Beautiful Styling: Professional HTML output with modern CSS
Installation
pip install askOmi
Quick Start
from askOmi import askOmi, html, inline_html
# Get AI response as text
response = askOmi("What is Python programming?")
# Generate separate HTML file
html("What is Python programming?")
# Add response to existing file or create new one
inline_html("What is Python programming?", "my_page.html")
Functions
askOmi(error)
Returns AI-generated response as plain text.
Parameters:
error(str): Your question or prompt
Returns:
str: AI-generated response
html(error)
Creates a separate HTML file (output.html) with the AI response.
Parameters:
error(str): Your question or prompt
inline_html(error, filename="index.html")
Adds AI response to an existing HTML file or creates a new one.
Parameters:
error(str): Your question or promptfilename(str, optional): Target HTML file (default: "index.html")
Features:
- If file doesn't exist: Creates new HTML file with styled layout
- If file exists: Appends styled response to existing content
get(error, style="inline")
Returns HTML content as a string instead of writing to a file. Perfect for using directly in Python code!
Parameters:
error(str): Your question or promptstyle(str): "inline" for appending style, "full" for complete HTML document
Returns:
str: HTML content as string
destroy()
Cleans up installed packages and generated files.
Examples
Basic Usage
from askOmi import askOmi
# Get text response
answer = askOmi("How do I learn programming?")
print(answer)
Generate HTML File
from askOmi import html
# Creates output.html with styled response
html("What are the best programming languages for beginners?")
Inline HTML Generation
from askOmi import inline_html
# Create new file or add to existing one
inline_html("What is machine learning?", "tutorial.html")
inline_html("How does AI work?", "tutorial.html") # Appends to same file
Get HTML as String (NEW!)
from askOmi import get
# Get HTML content as string (perfect for web apps!)
html_content = get("What is Python programming?", style="inline")
# Use in Flask/Django or any web framework
from flask import render_template_string
template = f'''
<!DOCTYPE html>
<html>
<head><title>My App</title></head>
<body>
<h1>Welcome</h1>
{html_content}
</body>
</html>
'''
# Get full HTML document
full_html = get("What is web development?", style="full")
Requirements
- Python 3.8+
- Google Generative AI API key
API Key Setup
The package uses Google's Gemini AI. Make sure you have a valid API key. The current implementation includes a hardcoded key, but for production use, consider using environment variables:
import os
from askOmi import askOmi
# Set your API key as environment variable
os.environ['GEMINI_API_KEY'] = 'your-api-key-here'
License
MIT License
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Support
If you encounter any issues or have questions, please open an issue on GitHub.
Release history Release notifications | RSS feed
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 askomi-0.5.tar.gz.
File metadata
- Download URL: askomi-0.5.tar.gz
- Upload date:
- Size: 3.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.12.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cac5386cb01e95a7da0ff16e96f3d68d799a63529703e7eacedd5cb0c9a0081f
|
|
| MD5 |
15f529c10d6c645760a54edfde97cf4e
|
|
| BLAKE2b-256 |
69b5aa09078ce3a8294889c904a875251463e29d748de14ca18831d28f79df10
|
File details
Details for the file askomi-0.5-py3-none-any.whl.
File metadata
- Download URL: askomi-0.5-py3-none-any.whl
- Upload date:
- Size: 3.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.12.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7fa9e857d072252f57790f0569b4ac19b91e03205744623671f3fcbfc1120619
|
|
| MD5 |
2047fce501754db0b62e1c99f353b96a
|
|
| BLAKE2b-256 |
7ea125387312019ff6c94f487b88f9189e97e51bded620f19b6e8e15363f47bd
|
