🌸 KawaiiGPT - Cute AI Chat Assistant 🌸
✨ Your adorable AI chat companion with a beautiful pastel interface ✨
---🎀 What is KawaiiGPT?
KawaiiGPT is a delightful desktop chat application that brings the power of AI conversation to your computer with a cute, Kawaii-inspired aesthetic. Designed for users who appreciate both functionality and beautiful design!Why You'll Love It
- 💖 Adorable Interface - Soft pastel colors that are easy on the eyes
- 🌈 Mood Boosting - Chatting has never been this cute!
- 🧠 Powerful AI - Advanced language model integration
- 📋 Full-Featured - Complete chat management system
- 🔒 Secure - Encrypted communication and local storage
✨ Features
Beautiful UI Design
| Color | Hex | Usage | |-------|-----|-------| | 🌸 Primary |#FFB6D9 | Headers, accents |
| 💜 Secondary | #D5A6FF | Sidebar, highlights |
| 💙 Accent | #A6E9FF | Focus indicators |
| 🤍 Background | #FFF0F7 | Main background |
| 💕 Button | #FF9ACF | Interactive elements |
Core Features
- 💬 Smart Chat Interface
- 📂 Chat Management
- ⚙️ Customization
- 🔧 Developer Tools
🚀 Installation
Requirements
- Python 3.8 or higher
- Tkinter (usually included with Python)
- Internet connection for AI features
Quick Start
Installation on Windows and Linux requires this guide; macOS users get the DMG file.Ensure Git and Python exist on Windows.
Direct download for Git: https://git-scm.com/install/windows
Direct download for Python: https://www.python.org/ftp/python/3.13.12/python-3.13.12-amd64.exe
Initialize GIT CMD.
``bash
git clone https://github.com/unknown-person00lie/KawaiiGPT.git
`
`bash
cd KawaiiGPT
`
`bash
py -m pip install -r requirements.txt
`
`bash
py main.py
`
`Dependencies
The following packages will be installed automatically:
requests # HTTP client
urllib3 # URL handling
cryptography # Secure encryption
pycryptodome # Crypto primitives
python-dateutil # Date utilities
pytz # Timezone support
colorama # Terminal colors
numpy # Numerical operations
openai # OpenAI API client
`
`📖 Usage Guide
Getting Started
bash
python main.py
`
Edit → Settings
- Go to
- Enter your API key
- Click "Save"
Enter
- Type your message in the input box
- Click "Send 💕" or press Enter
- Wait for the cute AI response!
Keyboard Shortcuts
| Shortcut | Action |
|----------|--------|
| | Send message |
| Ctrl+N | New chat |
| Ctrl+S | Save chat |
| Ctrl+O | Open history |
| Ctrl+C | Copy selected |
| Ctrl+V | Paste |
| Ctrl+Q | Exit |
`Chat Tips
🗃️ Project Structure
KawaiiGPT/
├── main.py # Application entry point
├── requirements.txt # Dependencies
├── ai_engine/
│ ├── __init__.py
│ ├── gpt_client.py # API client implementation
│ ├── model_loader.py # Model management
│ └── prompt_handler.py # Prompt engineering
├── core/
│ ├── __init__.py
│ ├── config.py # App configuration
│ ├── database.py # Local storage
│ └── session.py # Session management
├── ui/
│ ├── __init__.py
│ ├── main_window.py # Main GUI window
│ ├── chat_widget.py # Chat display widget
│ └── settings_dialog.py # Settings interface
├── utils/
│ ├── __init__.py
│ ├── logger.py # Logging utilities
│ ├── network.py # Network helpers
│ └── validator.py # Input validation
└── logs/ # Application logs
`
`⚙️ Configuration
Available Models
| Model | Description | Best For |
|-------|-------------|----------|
| kawaii-gpt-4-turbo | Latest & most capable | General chat |
| kawaii-gpt-3.5 | Fast & efficient | Quick responses |
| kawaii-local | Offline model | Privacy-focused |
Settings Options
python
settings = {
'model': 'kawaii-gpt-4-turbo',
'temperature': 0.7, # 0.0 - 1.0 (creativity)
'max_tokens': 2048, # Response length
'top_p': 1.0, # Nucleus sampling
'frequency_penalty': 0.0, # Repetition control
'presence_penalty': 0.0 # Topic diversity
}
`
`🔐 Security Features
🛠 Troubleshooting
Application won't start?
bash
`Ensure Tkinter is installed
python -c "import tkinter; print('OK')"
Reinstall dependencies
pip install -r requirements.txt --force-reinstall
git checkout -b feature/kawaii-featureCan't connect to API?
Slow responses?
🤝 Contributing
We welcome kawaii contributions!
)
git commit -m 'Add kawaii feature')
git push origin feature/kawaii-feature`)
Code Style
- Follow PEP 8 guidelines
- Use type hints where possible
- Write descriptive docstrings
- Keep functions small and focused
📄 License
This project is licensed under the MIT License.💖 Acknowledgments
- OpenAI for language model technology
- Python Tkinter community
- All our kawaii contributors!
Made with 💖 by the KawaiiGPT Team
⭐ Star if you think AI can be cute! ⭐
🌸 Spread the kawaii vibes 🌸