Skip to content
bluedinosaur139 edited this page Oct 2, 2024 · 6 revisions

CatGPTMascots

CatGPT: The Ultimate Feline Chat Assistant

Welcome to CatGPT!

This is not your typical AI assistant. CatGPT combines the power of OpenAI's GPT architecture with a bit of feline flair—cute, efficient, and maybe a little playful—bringing a whole new perspective to your desktop environment. Imagine an AI cat-girl helping you manage tasks, chat, and even transcribe your speech using state-of-the-art technology like the Vosk API!

Project Overview

CatGPT began as a simple experiment: take a lightweight Electron-based interface and combine it with the OpenAI GPT API to create a desktop application. Along the way, this concept grew, incorporating additional functionalities, smooth integration with various packages, and my favorite part—adding a playful cat-girl interface to lighten up the user experience.

The app is designed to streamline interaction with OpenAI's chat model without needing a browser interface. It loads quickly and runs efficiently, thanks to minimal overhead and clever optimizations.

Plus, who wouldn't want their digital assistant to have the attitude and charm of a cat-girl? 😸

Current Features:

Smooth Electron Interface: A responsive app that loads directly into OpenAI's ChatGPT web interface, providing faster interaction than typical browsers. Vosk Speech-to-Text (WIP): Vosk will handle offline speech recognition, enhancing your interactions with the assistant. We've run into some hiccups along the way (Vosk models, dependencies, etc.), but we're almost there! Automatic Dark Mode: Because every cat-girl assistant needs to work well in the dark. 🌙 Custom Icons: Featuring a cat-girl icon because aesthetics matter! Cross-Platform: Runs well on Linux (Arch and Debian distros), with Windows and macOS compatibility on the horizon.

Where We've Been This journey hasn't been without its challenges. At first, integrating the Vosk API for offline speech recognition posed a major hurdle, as most npm packages weren’t playing nice on Arch. A lot of this required working around npm and even skipping over the Node package manager completely.

We've also dealt with:

Permission Issues: NPM permissions have caused us countless hours of fun (well, not really), but we made sure to work around those with proper permission management. Python Environments: Managing multiple Python versions and creating venv instances for Vosk support has added complexity but has proven necessary for smooth speech recognition. Rolling Arch: You'd think the rolling release of Arch would be smooth, but when combined with fish shell scripts, there were bound to be issues. Still, Arch is superior for getting the latest security patches and that bleeding edge experience.

Where We're Headed

Now that the basics are working, we're only a few steps away from creating the ultimate cat-girl assistant experience. Here's the roadmap to completing CatGPT:

Finalize Vosk Speech-to-Text:

We're refining the Vosk integration and ensuring smooth audio processing with offline capabilities. This will allow users to transcribe and interact with CatGPT without needing to type! Future Plan: Automate Vosk's virtual environment setup as part of the installation process. Installer & Desktop Entries:

The setup process will be streamlined with scripts that handle virtual environment creation, package installations, and desktop shortcuts automatically. You’ll be able to launch CatGPT with a simple icon on your desktop, no need to dig into terminal commands.

Cross-Platform Linux Only:

CatGPT works great on Linux, with both x64 and ARM64 support o-o-b, and it is even accessible with the installer script, ensuring the app feels native on any Linux platform. Windows nor mac will get any love from me, since recall and copilot scared me off finally now I'm free, and so is software!!!!!

Customization:

Planned theme options for your digital cat-girl (because personalizing your AI assistant is half the fun). Potential expansion for more voice packs, animations, or mini-games—keeping CatGPT fun and interactive. For now the app follows whatever your os uses for a desktop theme, dark or light and even respects kde themes where it was built and tested on my pc and pi 5.

How to Use (Installation)

Step 1: Clone the Repo

git clone https://github.com/YourRepo/CatGPT.git; cd CatGPT

Step 2: Set Up the Virtual Environment (For Vosk)

python3 -m venv venv; source venv/bin/activate; pip install -r requirements.txt

Step 3: Run the Application

npm install; npm start

Step 4: Optional - Install Desktop Entry (Linux)

sudo cp catgpt.desktop /usr/share/applications/

This adds a launcher to your desktop environment, making CatGPT easy to launch with a single click! Well eventually it's a work in progress, nya!

Final Thoughts

CatGPT isn't just an AI assistant—it's a whimsical and effective companion for your daily tasks. With the power of GPT combined with offline speech recognition and cross-platform support, CatGPT aims to be the purr-fect desktop assistant.

The journey is almost complete, and soon CatGPT will not only chat but also understand spoken commands seamlessly!

Stay tuned for more updates as we finish integrating speech recognition and polish off the app with a shiny bow (and maybe a little catnip).

Contributions: PRs, issues, and discussions are always welcome. If you're a cat lover with a knack for code, feel free to join the team!

😸 Meow! - From your favorite digital cat-girl, bringing you the best AI experience!

Just a teaser of CatGpt OS:

Screenshot_20240926_055543

Screenshot_20240926_041249

Screenshot_20240923_192415

Screenshot_20240926_062636

Screenshot_20240927_174720

Screenshot_20240927_151837

Screenshot_20240929_020837

Screenshot_20241001_193405

Screenshot_20241002_032559

Clone this wiki locally